1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2024-09-14 20:13:21 +02:00

Add version_added for all new features (#214)

* Add version_added: 1.0.0 for all new features added before pre-ansible-base.

* Add version_added: 1.0.0 for all new features.

* Next release will be 0.2.0

* Fix error.

* Remove unnecessary warnings.
This commit is contained in:
Felix Fontein 2020-06-13 15:01:19 +02:00 committed by GitHub
parent c081bb6c9c
commit f9589d78a8
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
102 changed files with 220 additions and 10 deletions

View file

@ -1,2 +1,2 @@
bugfixes: minor_changes:
- Add validate_certs in rhn_channel module (https://github.com/ansible/ansible/issues/68374). - "rhn_channel - Added ``validate_certs`` option (https://github.com/ansible/ansible/issues/68374)."

View file

@ -1,6 +1,6 @@
namespace: community namespace: community
name: general name: general
version: 0.1.1 version: 0.2.0
readme: README.md readme: README.md
authors: authors:
- Ansible (https://github.com/ansible) - Ansible (https://github.com/ansible)

View file

@ -38,6 +38,7 @@ options:
description: description:
- The path on which InfluxDB server is accessible - The path on which InfluxDB server is accessible
type: str type: str
version_added: '0.2.0'
validate_certs: validate_certs:
description: description:
- If set to C(no), the SSL certificates will not be validated. - If set to C(no), the SSL certificates will not be validated.

View file

@ -36,6 +36,7 @@ options:
description: description:
- Number of seconds to sleep between checks. - Number of seconds to sleep between checks.
default: 5 default: 5
version_added: '0.2.0'
memory: memory:
description: description:
- The amount of memory to be requested by virtual machine. - The amount of memory to be requested by virtual machine.

View file

@ -9,6 +9,7 @@ __metaclass__ = type
DOCUMENTATION = ''' DOCUMENTATION = '''
author: author:
- Eric Belhomme <ebelhomme@fr.scc.com> - Eric Belhomme <ebelhomme@fr.scc.com>
version_added: '0.2.0'
lookup: etcd3 lookup: etcd3
short_description: Get key values from etcd3 server short_description: Get key values from etcd3 server
description: description:

View file

@ -42,12 +42,14 @@ DOCUMENTATION = """
ini: ini:
- section: lookup_hashi_vault - section: lookup_hashi_vault
key: token_path key: token_path
version_added: '0.2.0'
token_file: token_file:
description: If no token is specified, will try to read the token from this file in C(token_path). description: If no token is specified, will try to read the token from this file in C(token_path).
ini: ini:
- section: lookup_hashi_vault - section: lookup_hashi_vault
key: token_file key: token_file
default: '.vault-token' default: '.vault-token'
version_added: '0.2.0'
url: url:
description: URL to vault service. description: URL to vault service.
env: env:
@ -55,6 +57,7 @@ DOCUMENTATION = """
ini: ini:
- section: lookup_hashi_vault - section: lookup_hashi_vault
key: url key: url
version_added: '0.2.0'
default: 'http://127.0.0.1:8200' default: 'http://127.0.0.1:8200'
username: username:
description: Authentication user name. description: Authentication user name.
@ -67,6 +70,7 @@ DOCUMENTATION = """
ini: ini:
- section: lookup_hashi_vault - section: lookup_hashi_vault
key: role_id key: role_id
version_added: '0.2.0'
secret_id: secret_id:
description: Secret id for a vault AppRole auth. description: Secret id for a vault AppRole auth.
env: env:
@ -81,6 +85,7 @@ DOCUMENTATION = """
ini: ini:
- section: lookup_hashi_vault - section: lookup_hashi_vault
key: auth_method key: auth_method
version_added: '0.2.0'
choices: choices:
- token - token
- userpass - userpass
@ -100,6 +105,7 @@ DOCUMENTATION = """
- raw - raw
default: dict default: dict
aliases: [ as ] aliases: [ as ]
version_added: '0.2.0'
mount_point: mount_point:
description: Vault mount point, only required if you have a custom mount point. description: Vault mount point, only required if you have a custom mount point.
ca_cert: ca_cert:
@ -118,6 +124,7 @@ DOCUMENTATION = """
env: env:
- name: AWS_DEFAULT_PROFILE - name: AWS_DEFAULT_PROFILE
- name: AWS_PROFILE - name: AWS_PROFILE
version_added: '0.2.0'
aws_access_key: aws_access_key:
description: The AWS access key to use. description: The AWS access key to use.
type: str type: str
@ -126,6 +133,7 @@ DOCUMENTATION = """
- name: EC2_ACCESS_KEY - name: EC2_ACCESS_KEY
- name: AWS_ACCESS_KEY - name: AWS_ACCESS_KEY
- name: AWS_ACCESS_KEY_ID - name: AWS_ACCESS_KEY_ID
version_added: '0.2.0'
aws_secret_key: aws_secret_key:
description: The AWS secret key that corresponds to the access key. description: The AWS secret key that corresponds to the access key.
type: str type: str
@ -134,6 +142,7 @@ DOCUMENTATION = """
- name: EC2_SECRET_KEY - name: EC2_SECRET_KEY
- name: AWS_SECRET_KEY - name: AWS_SECRET_KEY
- name: AWS_SECRET_ACCESS_KEY - name: AWS_SECRET_ACCESS_KEY
version_added: '0.2.0'
aws_security_token: aws_security_token:
description: The AWS security token if using temporary access and secret keys. description: The AWS security token if using temporary access and secret keys.
type: str type: str
@ -141,12 +150,14 @@ DOCUMENTATION = """
- name: EC2_SECURITY_TOKEN - name: EC2_SECURITY_TOKEN
- name: AWS_SESSION_TOKEN - name: AWS_SESSION_TOKEN
- name: AWS_SECURITY_TOKEN - name: AWS_SECURITY_TOKEN
version_added: '0.2.0'
region: region:
description: The AWS region for which to create the connection. description: The AWS region for which to create the connection.
type: str type: str
env: env:
- name: EC2_REGION - name: EC2_REGION
- name: AWS_REGION - name: AWS_REGION
version_added: '0.2.0'
""" """
EXAMPLES = """ EXAMPLES = """

View file

@ -8,6 +8,7 @@ DOCUMENTATION = '''
lookup: lmdb_kv lookup: lmdb_kv
author: author:
- Jan-Piet Mens (@jpmens) - Jan-Piet Mens (@jpmens)
version_added: '0.2.0'
short_description: fetch data from LMDB short_description: fetch data from LMDB
description: description:
- This lookup returns a list of results from an LMDB DB corresponding to a list of items given to it - This lookup returns a list of results from an LMDB DB corresponding to a list of items given to it

View file

@ -34,6 +34,7 @@ DOCUMENTATION = """
lookup: sops lookup: sops
author: Edoardo Tenani (@endorama) <e.tenani@arduino.cc> author: Edoardo Tenani (@endorama) <e.tenani@arduino.cc>
short_description: Read sops encrypted file contents short_description: Read sops encrypted file contents
version_added: '0.2.0'
description: description:
- This lookup returns the contents from a file on the Ansible controller's file system. - This lookup returns the contents from a file on the Ansible controller's file system.
- This lookup requires the C(sops) executable to be available in the controller PATH. - This lookup requires the C(sops) executable to be available in the controller PATH.

View file

@ -102,6 +102,7 @@ options:
The sequential suffix ranges from 001 to 999. The sequential suffix ranges from 001 to 999.
default: False default: False
type: bool type: bool
version_added: '0.2.0'
password: password:
description: description:
- The password to login instance. After rebooting instances, modified password will take effect. - The password to login instance. After rebooting instances, modified password will take effect.
@ -182,12 +183,14 @@ options:
- A hash/dictionaries of instance tags, to add to the new instance or for starting/stopping instance by tag. C({"key":"value"}) - A hash/dictionaries of instance tags, to add to the new instance or for starting/stopping instance by tag. C({"key":"value"})
aliases: ["instance_tags"] aliases: ["instance_tags"]
type: dict type: dict
version_added: '0.2.0'
purge_tags: purge_tags:
description: description:
- Delete any tags not specified in the task that are on the instance. - Delete any tags not specified in the task that are on the instance.
If True, it means you have to specify all the desired tags on each task affecting an instance. If True, it means you have to specify all the desired tags on each task affecting an instance.
default: False default: False
type: bool type: bool
version_added: '0.2.0'
key_name: key_name:
description: description:
- The name of key pair which is used to access ECS instance in SSH. - The name of key pair which is used to access ECS instance in SSH.
@ -204,23 +207,27 @@ options:
description: description:
- The name of the instance RAM role. - The name of the instance RAM role.
type: str type: str
version_added: '0.2.0'
spot_price_limit: spot_price_limit:
description: description:
- The maximum hourly price for the preemptible instance. This parameter supports a maximum of three decimal - The maximum hourly price for the preemptible instance. This parameter supports a maximum of three decimal
places and takes effect when the SpotStrategy parameter is set to SpotWithPriceLimit. places and takes effect when the SpotStrategy parameter is set to SpotWithPriceLimit.
type: float type: float
version_added: '0.2.0'
spot_strategy: spot_strategy:
description: description:
- The bidding mode of the pay-as-you-go instance. This parameter is valid when InstanceChargeType is set to PostPaid. - The bidding mode of the pay-as-you-go instance. This parameter is valid when InstanceChargeType is set to PostPaid.
choices: ['NoSpot', 'SpotWithPriceLimit', 'SpotAsPriceGo'] choices: ['NoSpot', 'SpotWithPriceLimit', 'SpotAsPriceGo']
default: 'NoSpot' default: 'NoSpot'
type: str type: str
version_added: '0.2.0'
period_unit: period_unit:
description: description:
- The duration unit that you will buy the resource. It is valid when C(instance_charge_type=PrePaid) - The duration unit that you will buy the resource. It is valid when C(instance_charge_type=PrePaid)
choices: ['Month', 'Week'] choices: ['Month', 'Week']
default: 'Month' default: 'Month'
type: str type: str
version_added: '0.2.0'
dry_run: dry_run:
description: description:
- Specifies whether to send a dry-run request. - Specifies whether to send a dry-run request.
@ -230,11 +237,13 @@ options:
- If I(dry_run=False), A request is sent. If the validation succeeds, the instance is created. - If I(dry_run=False), A request is sent. If the validation succeeds, the instance is created.
default: False default: False
type: bool type: bool
version_added: '0.2.0'
include_data_disks: include_data_disks:
description: description:
- Whether to change instance disks charge type when changing instance charge type. - Whether to change instance disks charge type when changing instance charge type.
default: True default: True
type: bool type: bool
version_added: '0.2.0'
author: author:
- "He Guimin (@xiaozhu36)" - "He Guimin (@xiaozhu36)"
requirements: requirements:

View file

@ -54,6 +54,7 @@ options:
description: description:
- Use a instance name prefix to filter ecs instances. - Use a instance name prefix to filter ecs instances.
type: str type: str
version_added: '0.2.0'
tags: tags:
description: description:
- A hash/dictionaries of instance tags. C({"key":"value"}) - A hash/dictionaries of instance tags. C({"key":"value"})
@ -67,6 +68,7 @@ options:
connect different words in one parameter. 'InstanceIds' should be a list and it will be appended to connect different words in one parameter. 'InstanceIds' should be a list and it will be appended to
I(instance_ids) automatically. 'Tag.n.Key' and 'Tag.n.Value' should be a dict and using I(tags) instead. I(instance_ids) automatically. 'Tag.n.Key' and 'Tag.n.Value' should be a dict and using I(tags) instead.
type: dict type: dict
version_added: '0.2.0'
author: author:
- "He Guimin (@xiaozhu36)" - "He Guimin (@xiaozhu36)"
requirements: requirements:

View file

@ -58,6 +58,7 @@ options:
If omitted, the region of the project default zone is used. If omitted, the region of the project default zone is used.
This parameter must be omitted if I(type) is set to C(global). This parameter must be omitted if I(type) is set to C(global).
type: str type: str
version_added: '0.2.0'
prefix_length: prefix_length:
description: description:
- Only valid if I(ip_version) is 6. - Only valid if I(ip_version) is 6.
@ -153,6 +154,7 @@ region:
returned: success when state == present returned: success when state == present
type: dict type: dict
sample: {'slug': 'lpg'} sample: {'slug': 'lpg'}
version_added: '0.2.0'
state: state:
description: The current status of the floating IP. description: The current status of the floating IP.
returned: success returned: success

View file

@ -54,6 +54,7 @@ options:
description: description:
- Zone in which the server resides (e.g. C(lgp1) or C(rma1)). - Zone in which the server resides (e.g. C(lgp1) or C(rma1)).
type: str type: str
version_added: '0.2.0'
volume_size_gb: volume_size_gb:
description: description:
- Size of the root volume in GB. - Size of the root volume in GB.
@ -220,6 +221,7 @@ zone:
returned: success when not state == absent returned: success when not state == absent
type: dict type: dict
sample: { 'slug': 'lpg1' } sample: { 'slug': 'lpg1' }
version_added: '0.2.0'
volumes: volumes:
description: List of volumes attached to the server description: List of volumes attached to the server
returned: success when not state == absent returned: success when not state == absent

View file

@ -37,6 +37,7 @@ options:
description: description:
- Zone slug of the server group (e.g. C(lgp1) or C(rma1)). - Zone slug of the server group (e.g. C(lgp1) or C(rma1)).
type: str type: str
version_added: '0.2.0'
state: state:
description: description:
- State of the server group. - State of the server group.
@ -101,6 +102,7 @@ zone:
returned: success returned: success
type: dict type: dict
sample: { 'slug': 'rma1' } sample: { 'slug': 'rma1' }
version_added: '0.2.0'
servers: servers:
description: A list of servers that are part of the server group. description: A list of servers that are part of the server group.
returned: if available returned: if available

View file

@ -56,6 +56,7 @@ options:
- Zone in which the volume resides (e.g. C(lgp1) or C(rma1)). Cannot be - Zone in which the volume resides (e.g. C(lgp1) or C(rma1)). Cannot be
changed after creating the volume. Defaults to the project default zone. changed after creating the volume. Defaults to the project default zone.
type: str type: str
version_added: '0.2.0'
server_uuids: server_uuids:
description: description:
- UUIDs of the servers this volume is attached to. Set this to C([]) to - UUIDs of the servers this volume is attached to. Set this to C([]) to
@ -146,6 +147,7 @@ zone:
returned: state == present returned: state == present
type: dict type: dict
sample: {'slug': 'lpg1'} sample: {'slug': 'lpg1'}
version_added: '0.2.0'
server_uuids: server_uuids:
description: The UUIDs of the servers this volume is attached to. description: The UUIDs of the servers this volume is attached to.
returned: state == present returned: state == present

View file

@ -98,6 +98,7 @@ options:
choices: choices:
- compatibility - compatibility
- no_defaults - no_defaults
version_added: '0.2.0'
cpu_period: cpu_period:
description: description:
- Limit CPU CFS (Completely Fair Scheduler) period. - Limit CPU CFS (Completely Fair Scheduler) period.
@ -113,6 +114,7 @@ options:
- Specify how much of the available CPU resources a container can use. - Specify how much of the available CPU resources a container can use.
- A value of C(1.5) means that at most one and a half CPU (core) will be used. - A value of C(1.5) means that at most one and a half CPU (core) will be used.
type: float type: float
version_added: '0.2.0'
cpuset_cpus: cpuset_cpus:
description: description:
- CPUs in which to allow execution C(1,3) or C(1-3). - CPUs in which to allow execution C(1,3) or C(1-3).
@ -669,6 +671,7 @@ options:
removed. If the container is still in the removal phase after this many seconds, the module will removed. If the container is still in the removal phase after this many seconds, the module will
fail. fail.
type: float type: float
version_added: '0.2.0'
restart: restart:
description: description:
- Use with started state to force a matching container to be stopped and restarted. - Use with started state to force a matching container to be stopped and restarted.

View file

@ -190,6 +190,7 @@ options:
- Corresponds to the C(--init) option of C(docker service create). - Corresponds to the C(--init) option of C(docker service create).
- Requires API version >= 1.37. - Requires API version >= 1.37.
type: bool type: bool
version_added: '0.2.0'
labels: labels:
description: description:
- Dictionary of key value pairs. - Dictionary of key value pairs.

View file

@ -18,6 +18,7 @@ module: hwc_ecs_instance
description: description:
- instance management. - instance management.
short_description: Creates a resource of Ecs/Instance in Huawei Cloud short_description: Creates a resource of Ecs/Instance in Huawei Cloud
version_added: '0.2.0'
author: Huawei Inc. (@huaweicloud) author: Huawei Inc. (@huaweicloud)
requirements: requirements:
- keystoneauth1 >= 3.6.0 - keystoneauth1 >= 3.6.0

View file

@ -18,6 +18,7 @@ module: hwc_evs_disk
description: description:
- block storage management. - block storage management.
short_description: Creates a resource of Evs/Disk in Huawei Cloud short_description: Creates a resource of Evs/Disk in Huawei Cloud
version_added: '0.2.0'
author: Huawei Inc. (@huaweicloud) author: Huawei Inc. (@huaweicloud)
requirements: requirements:
- keystoneauth1 >= 3.6.0 - keystoneauth1 >= 3.6.0

View file

@ -18,6 +18,7 @@ module: hwc_vpc_eip
description: description:
- elastic ip management. - elastic ip management.
short_description: Creates a resource of Vpc/EIP in Huawei Cloud short_description: Creates a resource of Vpc/EIP in Huawei Cloud
version_added: '0.2.0'
author: Huawei Inc. (@huaweicloud) author: Huawei Inc. (@huaweicloud)
requirements: requirements:
- keystoneauth1 >= 3.6.0 - keystoneauth1 >= 3.6.0

View file

@ -19,6 +19,7 @@ module: hwc_vpc_peering_connect
description: description:
- vpc peering management. - vpc peering management.
short_description: Creates a resource of Vpc/PeeringConnect in Huawei Cloud short_description: Creates a resource of Vpc/PeeringConnect in Huawei Cloud
version_added: '0.2.0'
author: Huawei Inc. (@huaweicloud) author: Huawei Inc. (@huaweicloud)
requirements: requirements:
- keystoneauth1 >= 3.6.0 - keystoneauth1 >= 3.6.0

View file

@ -18,6 +18,7 @@ module: hwc_vpc_port
description: description:
- vpc port management. - vpc port management.
short_description: Creates a resource of Vpc/Port in Huawei Cloud short_description: Creates a resource of Vpc/Port in Huawei Cloud
version_added: '0.2.0'
author: Huawei Inc. (@huaweicloud) author: Huawei Inc. (@huaweicloud)
requirements: requirements:
- keystoneauth1 >= 3.6.0 - keystoneauth1 >= 3.6.0

View file

@ -22,6 +22,7 @@ notes:
- If I(id) option is provided, it takes precedence over I(subnet_id), I(ip_address) for private ip selection. - If I(id) option is provided, it takes precedence over I(subnet_id), I(ip_address) for private ip selection.
- I(subnet_id), I(ip_address) are used for private ip selection. If more than one private ip with this options exists, execution is aborted. - I(subnet_id), I(ip_address) are used for private ip selection. If more than one private ip with this options exists, execution is aborted.
- No parameter support updating. If one of option is changed, the module will create a new resource. - No parameter support updating. If one of option is changed, the module will create a new resource.
version_added: '0.2.0'
author: Huawei Inc. (@huaweicloud) author: Huawei Inc. (@huaweicloud)
requirements: requirements:
- keystoneauth1 >= 3.6.0 - keystoneauth1 >= 3.6.0

View file

@ -22,6 +22,7 @@ notes:
- If I(id) option is provided, it takes precedence over I(destination), I(vpc_id), I(type) and I(next_hop) for route selection. - If I(id) option is provided, it takes precedence over I(destination), I(vpc_id), I(type) and I(next_hop) for route selection.
- I(destination), I(vpc_id), I(type) and I(next_hop) are used for route selection. If more than one route with this options exists, execution is aborted. - I(destination), I(vpc_id), I(type) and I(next_hop) are used for route selection. If more than one route with this options exists, execution is aborted.
- No parameter support updating. If one of option is changed, the module will create a new resource. - No parameter support updating. If one of option is changed, the module will create a new resource.
version_added: '0.2.0'
author: Huawei Inc. (@huaweicloud) author: Huawei Inc. (@huaweicloud)
requirements: requirements:
- keystoneauth1 >= 3.6.0 - keystoneauth1 >= 3.6.0

View file

@ -26,6 +26,7 @@ notes:
execution is aborted. execution is aborted.
- No parameter support updating. If one of option is changed, the module - No parameter support updating. If one of option is changed, the module
will create a new resource. will create a new resource.
version_added: '0.2.0'
author: Huawei Inc. (@huaweicloud) author: Huawei Inc. (@huaweicloud)
requirements: requirements:
- keystoneauth1 >= 3.6.0 - keystoneauth1 >= 3.6.0

View file

@ -26,6 +26,7 @@ notes:
aborted. aborted.
- No parameter support updating. If one of option is changed, the module - No parameter support updating. If one of option is changed, the module
will create a new resource. will create a new resource.
version_added: '0.2.0'
author: Huawei Inc. (@huaweicloud) author: Huawei Inc. (@huaweicloud)
requirements: requirements:
- keystoneauth1 >= 3.6.0 - keystoneauth1 >= 3.6.0

View file

@ -18,6 +18,7 @@ module: hwc_vpc_subnet
description: description:
- subnet management. - subnet management.
short_description: Creates a resource of Vpc/Subnet in Huawei Cloud short_description: Creates a resource of Vpc/Subnet in Huawei Cloud
version_added: '0.2.0'
author: Huawei Inc. (@huaweicloud) author: Huawei Inc. (@huaweicloud)
requirements: requirements:
- keystoneauth1 >= 3.6.0 - keystoneauth1 >= 3.6.0

View file

@ -134,10 +134,12 @@ options:
- Specify the description for the container. Only used on the configuration web interface. - Specify the description for the container. Only used on the configuration web interface.
- This is saved as a comment inside the configuration file. - This is saved as a comment inside the configuration file.
type: str type: str
version_added: '0.2.0'
hookscript: hookscript:
description: description:
- Script that will be executed during various steps in the containers lifetime. - Script that will be executed during various steps in the containers lifetime.
type: str type: str
version_added: '0.2.0'
notes: notes:
- Requires proxmoxer and requests modules on host. This modules can be installed with pip. - Requires proxmoxer and requests modules on host. This modules can be installed with pip.

View file

@ -55,6 +55,7 @@ options:
description: description:
- The path to a variables file for Terraform to fill into the TF - The path to a variables file for Terraform to fill into the TF
configurations. This can accept a list of paths to multiple variables files. configurations. This can accept a list of paths to multiple variables files.
- Up until Ansible 2.9, this option was usable as I(variables_file).
type: list type: list
elements: path elements: path
aliases: [ 'variables_file' ] aliases: [ 'variables_file' ]
@ -91,6 +92,7 @@ options:
This can accept a list of paths to multiple configuration files. This can accept a list of paths to multiple configuration files.
type: list type: list
elements: path elements: path
version_added: '0.2.0'
notes: notes:
- To just run a `terraform plan`, use check mode. - To just run a `terraform plan`, use check mode.
requirements: [ "terraform" ] requirements: [ "terraform" ]

View file

@ -172,12 +172,15 @@ options:
- Create a private persistent copy of the template plus any image defined in DISK, and instantiate that copy. - Create a private persistent copy of the template plus any image defined in DISK, and instantiate that copy.
default: NO default: NO
type: bool type: bool
version_added: '0.2.0'
datastore_id: datastore_id:
description: description:
- Name of Datastore to use to create a new instace - Name of Datastore to use to create a new instace
version_added: '0.2.0'
datastore_name: datastore_name:
description: description:
- Name of Datastore to use to create a new instace - Name of Datastore to use to create a new instace
version_added: '0.2.0'
author: author:
- "Milan Ilic (@ilicmilan)" - "Milan Ilic (@ilicmilan)"
- "Jan Meerkamp (@meerkampdvv)" - "Jan Meerkamp (@meerkampdvv)"

View file

@ -12,6 +12,7 @@ DOCUMENTATION = '''
--- ---
module: ovh_monthly_billing module: ovh_monthly_billing
author: Francois Lallart (@fraff) author: Francois Lallart (@fraff)
version_added: '0.2.0'
short_description: Manage OVH monthly billing short_description: Manage OVH monthly billing
description: description:
- Enable monthly billing on OVH cloud intances (be aware OVH does not allow to disable it). - Enable monthly billing on OVH cloud intances (be aware OVH does not allow to disable it).

View file

@ -52,6 +52,7 @@ options:
- Currently implemented only for device creation. - Currently implemented only for device creation.
type: list type: list
elements: str elements: str
version_added: '0.2.0'
facility: facility:
description: description:

View file

@ -21,6 +21,7 @@ description:
- IPv6 subnets must come from publicly routable /56 block from your project. - IPv6 subnets must come from publicly routable /56 block from your project.
- See U(https://support.packet.com/kb/articles/elastic-ips) for more info on IP block reservation. - See U(https://support.packet.com/kb/articles/elastic-ips) for more info on IP block reservation.
version_added: '0.2.0'
author: author:
- Tomas Karasek (@t0mk) <tom.to.the.k@gmail.com> - Tomas Karasek (@t0mk) <tom.to.the.k@gmail.com>

View file

@ -19,6 +19,7 @@ description:
- Create/delete a project in Packet host. - Create/delete a project in Packet host.
- API is documented at U(https://www.packet.com/developers/api/#projects). - API is documented at U(https://www.packet.com/developers/api/#projects).
version_added: '0.2.0'
author: author:
- Tomas Karasek (@t0mk) <tom.to.the.k@gmail.com> - Tomas Karasek (@t0mk) <tom.to.the.k@gmail.com>

View file

@ -18,6 +18,7 @@ description:
- Create/delete a volume in Packet host. - Create/delete a volume in Packet host.
- API is documented at U(https://www.packet.com/developers/api/#volumes). - API is documented at U(https://www.packet.com/developers/api/#volumes).
version_added: '0.2.0'
author: author:
- Tomas Karasek (@t0mk) <tom.to.the.k@gmail.com> - Tomas Karasek (@t0mk) <tom.to.the.k@gmail.com>

View file

@ -22,6 +22,7 @@ description:
the block devices on the server, you have to run the Attach Scripts, 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)." as documented at U(https://help.packet.net/technical/storage/packet-block-storage-linux)."
version_added: '0.2.0'
author: author:
- Tomas Karasek (@t0mk) <tom.to.the.k@gmail.com> - Tomas Karasek (@t0mk) <tom.to.the.k@gmail.com>

View file

@ -61,6 +61,7 @@ options:
flavor: flavor:
description: description:
- Specify which SoftLayer flavor template to use instead of cpus and memory. - Specify which SoftLayer flavor template to use instead of cpus and memory.
version_added: '0.2.0'
disks: disks:
description: description:
- List of disk sizes to be assigned to new virtual instance. - List of disk sizes to be assigned to new virtual instance.

View file

@ -12,6 +12,7 @@ DOCUMENTATION = r'''
--- ---
module: redis_info module: redis_info
short_description: Gather information about Redis servers short_description: Gather information about Redis servers
version_added: '0.2.0'
description: description:
- Gathers information and statistics about Redis servers. - Gathers information and statistics about Redis servers.
options: options:

View file

@ -73,6 +73,7 @@ options:
required: no required: no
default: no default: no
type: bool type: bool
version_added: '0.2.0'
force: force:
description: description:
- Continue dump or import even if we get an SQL error. - Continue dump or import even if we get an SQL error.
@ -80,6 +81,7 @@ options:
required: no required: no
type: bool type: bool
default: no default: no
version_added: '0.2.0'
master_data: master_data:
description: description:
- Option to dump a master replication server to produce a dump file - Option to dump a master replication server to produce a dump file
@ -93,18 +95,21 @@ options:
type: int type: int
choices: [0, 1, 2] choices: [0, 1, 2]
default: 0 default: 0
version_added: '0.2.0'
skip_lock_tables: skip_lock_tables:
description: description:
- Skip locking tables for read. Used when I(state=dump), ignored otherwise. - Skip locking tables for read. Used when I(state=dump), ignored otherwise.
required: no required: no
type: bool type: bool
default: no default: no
version_added: '0.2.0'
dump_extra_args: dump_extra_args:
description: description:
- Provide additional arguments for mysqldump. - Provide additional arguments for mysqldump.
Used when I(state=dump) only, ignored otherwise. Used when I(state=dump) only, ignored otherwise.
required: no required: no
type: str type: str
version_added: '0.2.0'
use_shell: use_shell:
description: description:
- Used to prevent C(Broken pipe) errors when the imported I(target) file is compressed. - Used to prevent C(Broken pipe) errors when the imported I(target) file is compressed.
@ -113,6 +118,7 @@ options:
required: no required: no
type: bool type: bool
default: no default: no
version_added: '0.2.0'
unsafe_login_password: unsafe_login_password:
description: description:
- If C(no), the module will safely use a shell-escaped version of the I(login_password) value. - If C(no), the module will safely use a shell-escaped version of the I(login_password) value.
@ -120,6 +126,7 @@ options:
- Used only when I(state) is C(import) or C(dump) and I(login_password) is passed, ignored otherwise. - Used only when I(state) is C(import) or C(dump) and I(login_password) is passed, ignored otherwise.
type: bool type: bool
default: no default: no
version_added: '0.2.0'
restrict_config_file: restrict_config_file:
description: description:
- Read only passed I(config_file). - Read only passed I(config_file).
@ -129,12 +136,14 @@ options:
- If this behavior is undesirable, use C(yes) to read only named option file. - If this behavior is undesirable, use C(yes) to read only named option file.
type: bool type: bool
default: no default: no
version_added: '0.2.0'
check_implicit_admin: check_implicit_admin:
description: description:
- Check if mysql allows login as root/nopassword before trying supplied credentials. - Check if mysql allows login as root/nopassword before trying supplied credentials.
- If success, passed I(login_user)/I(login_password) will be ignored. - If success, passed I(login_user)/I(login_password) will be ignored.
type: bool type: bool
default: no default: no
version_added: '0.2.0'
seealso: seealso:
- module: mysql_info - module: mysql_info
@ -291,6 +300,7 @@ executed_commands:
returned: if executed returned: if executed
type: list type: list
sample: ["CREATE DATABASE acme"] sample: ["CREATE DATABASE acme"]
version_added: '0.2.0'
''' '''
import os import os

View file

@ -37,6 +37,7 @@ options:
- "Supports elements: C(db_size). Unsupported elements will be ignored" - "Supports elements: C(db_size). Unsupported elements will be ignored"
type: list type: list
elements: str elements: str
version_added: '0.2.0'
return_empty_dbs: return_empty_dbs:
description: description:
- Includes names of empty databases to returned dictionary. - Includes names of empty databases to returned dictionary.

View file

@ -15,6 +15,7 @@ description:
- Runs arbitrary MySQL queries. - Runs arbitrary MySQL queries.
- Pay attention, the module does not support check mode! - Pay attention, the module does not support check mode!
All queries will be executed in autocommit mode. All queries will be executed in autocommit mode.
version_added: '0.2.0'
options: options:
query: query:
description: description:

View file

@ -115,12 +115,14 @@ options:
- Available since MariaDB 10.0.2. - Available since MariaDB 10.0.2.
choices: [current_pos, slave_pos, disabled] choices: [current_pos, slave_pos, disabled]
type: str type: str
version_added: '0.2.0'
master_delay: master_delay:
description: description:
- Time lag behind the master's state (in seconds). - Time lag behind the master's state (in seconds).
- Available from MySQL 5.6. - Available from MySQL 5.6.
- For more information see U(https://dev.mysql.com/doc/refman/8.0/en/replication-delayed.html). - For more information see U(https://dev.mysql.com/doc/refman/8.0/en/replication-delayed.html).
type: int type: int
version_added: '0.2.0'
connection_name: connection_name:
description: description:
- Name of the master connection. - Name of the master connection.
@ -128,6 +130,7 @@ options:
- Mutually exclusive with I(channel). - Mutually exclusive with I(channel).
- For more information see U(https://mariadb.com/kb/en/library/multi-source-replication/). - For more information see U(https://mariadb.com/kb/en/library/multi-source-replication/).
type: str type: str
version_added: '0.2.0'
channel: channel:
description: description:
- Name of replication channel. - Name of replication channel.
@ -135,11 +138,13 @@ options:
- Mutually exclusive with I(connection_name). - Mutually exclusive with I(connection_name).
- For more information see U(https://dev.mysql.com/doc/refman/8.0/en/replication-multi-source.html). - For more information see U(https://dev.mysql.com/doc/refman/8.0/en/replication-multi-source.html).
type: str type: str
version_added: '0.2.0'
fail_on_error: fail_on_error:
description: description:
- Fails on error when calling mysql. - Fails on error when calling mysql.
type: bool type: bool
default: False default: False
version_added: '0.2.0'
notes: notes:
- If an empty value for the parameter of string type is needed, use an empty string. - If an empty value for the parameter of string type is needed, use an empty string.
@ -226,6 +231,7 @@ queries:
returned: always returned: always
type: list type: list
sample: ["CHANGE MASTER TO MASTER_HOST='master2.example.com',MASTER_PORT=3306"] sample: ["CHANGE MASTER TO MASTER_HOST='master2.example.com',MASTER_PORT=3306"]
version_added: '0.2.0'
''' '''
import os import os

View file

@ -89,14 +89,17 @@ options:
description: description:
- User's plugin to authenticate (``CREATE USER user IDENTIFIED WITH plugin``). - User's plugin to authenticate (``CREATE USER user IDENTIFIED WITH plugin``).
type: str type: str
version_added: '0.2.0'
plugin_hash_string: plugin_hash_string:
description: description:
- User's plugin hash string (``CREATE USER user IDENTIFIED WITH plugin AS plugin_hash_string``). - User's plugin hash string (``CREATE USER user IDENTIFIED WITH plugin AS plugin_hash_string``).
type: str type: str
version_added: '0.2.0'
plugin_auth_string: plugin_auth_string:
description: description:
- User's plugin auth_string (``CREATE USER user IDENTIFIED WITH plugin BY plugin_auth_string``). - User's plugin auth_string (``CREATE USER user IDENTIFIED WITH plugin BY plugin_auth_string``).
type: str type: str
version_added: '0.2.0'
resource_limits: resource_limits:
description: description:
- Limit the user for certain server resources. Provided since MySQL 5.6 / MariaDB 10.2. - Limit the user for certain server resources. Provided since MySQL 5.6 / MariaDB 10.2.
@ -104,6 +107,7 @@ options:
C(MAX_CONNECTIONS_PER_HOUR: num), C(MAX_USER_CONNECTIONS: num)." C(MAX_CONNECTIONS_PER_HOUR: num), C(MAX_USER_CONNECTIONS: num)."
- Used when I(state=present), ignored otherwise. - Used when I(state=present), ignored otherwise.
type: dict type: dict
version_added: '0.2.0'
notes: notes:
- "MySQL server installs with default login_user of 'root' and no password. To secure this user - "MySQL server installs with default login_user of 'root' and no password. To secure this user

View file

@ -42,6 +42,7 @@ options:
type: str type: str
choices: ['global', 'persist', 'persist_only'] choices: ['global', 'persist', 'persist_only']
default: global default: global
version_added: '0.2.0'
seealso: seealso:
- module: mysql_info - module: mysql_info
@ -72,6 +73,7 @@ queries:
returned: if executed returned: if executed
type: list type: list
sample: ["SET GLOBAL `read_only` = 1"] sample: ["SET GLOBAL `read_only` = 1"]
version_added: '0.2.0'
''' '''
import os import os

View file

@ -75,6 +75,7 @@ options:
- It makes sense to use C(yes) only when SQL injections are possible. - It makes sense to use C(yes) only when SQL injections are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
notes: notes:
- Supports PostgreSQL version 9.4+. - Supports PostgreSQL version 9.4+.
- COPY command is only allowed to database superusers. - COPY command is only allowed to database superusers.

View file

@ -101,6 +101,7 @@ options:
- Provides additional arguments when I(state) is C(dump). - Provides additional arguments when I(state) is C(dump).
- Cannot be used with dump-file-format-related arguments like ``--format=d``. - Cannot be used with dump-file-format-related arguments like ``--format=d``.
type: str type: str
version_added: '0.2.0'
trust_input: trust_input:
description: description:
- If C(no), check whether values of parameters I(owner), I(conn_limit), I(encoding), - If C(no), check whether values of parameters I(owner), I(conn_limit), I(encoding),
@ -108,6 +109,7 @@ options:
- It makes sense to use C(yes) only when SQL injections via the parameters are possible. - It makes sense to use C(yes) only when SQL injections via the parameters are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
seealso: seealso:
- name: CREATE DATABASE reference - name: CREATE DATABASE reference
description: Complete reference of the CREATE DATABASE command documentation. description: Complete reference of the CREATE DATABASE command documentation.
@ -200,6 +202,7 @@ executed_commands:
returned: always returned: always
type: list type: list
sample: ["CREATE DATABASE acme"] sample: ["CREATE DATABASE acme"]
version_added: '0.2.0'
''' '''

View file

@ -83,6 +83,7 @@ options:
- It makes sense to use C(yes) only when SQL injections via the parameters are possible. - It makes sense to use C(yes) only when SQL injections via the parameters are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
seealso: seealso:
- name: PostgreSQL extensions - name: PostgreSQL extensions
description: General information about PostgreSQL extensions. description: General information about PostgreSQL extensions.

View file

@ -88,6 +88,7 @@ options:
- Only btree currently supports unique indexes. - Only btree currently supports unique indexes.
type: bool type: bool
default: no default: no
version_added: '0.2.0'
tablespace: tablespace:
description: description:
- Set a tablespace for the index. - Set a tablespace for the index.
@ -116,6 +117,7 @@ options:
- It makes sense to use C(yes) only when SQL injections via the parameters are possible. - It makes sense to use C(yes) only when SQL injections via the parameters are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
seealso: seealso:
- module: postgresql_table - module: postgresql_table

View file

@ -46,6 +46,7 @@ options:
- It makes sense to use C(yes) only when SQL injections via I(session_role) are possible. - It makes sense to use C(yes) only when SQL injections via I(session_role) are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
seealso: seealso:
- module: postgresql_ping - module: postgresql_ping
author: author:
@ -244,6 +245,7 @@ databases:
returned: if configured returned: if configured
type: dict type: dict
sample: { "pub1": { "ownername": "postgres", "puballtables": true, "pubinsert": true, "pubupdate": true } } sample: { "pub1": { "ownername": "postgres", "puballtables": true, "pubinsert": true, "pubupdate": true } }
version_added: '0.2.0'
subscriptions: subscriptions:
description: description:
- Information about replication subscriptions (available for PostgreSQL 10 and higher) - Information about replication subscriptions (available for PostgreSQL 10 and higher)
@ -253,6 +255,7 @@ databases:
type: dict type: dict
sample: sample:
- { "my_subscription": {"ownername": "postgres", "subenabled": true, "subpublications": ["first_publication"] } } - { "my_subscription": {"ownername": "postgres", "subenabled": true, "subpublications": ["first_publication"] } }
version_added: '0.2.0'
repl_slots: repl_slots:
description: description:
- Replication slots (available in 9.4 and later) - Replication slots (available in 9.4 and later)

View file

@ -101,6 +101,7 @@ options:
- Set an owner for the language. - Set an owner for the language.
- Ignored when I(state=absent). - Ignored when I(state=absent).
type: str type: str
version_added: '0.2.0'
trust_input: trust_input:
description: description:
- If C(no), check whether values of parameters I(lang), I(session_role), - If C(no), check whether values of parameters I(lang), I(session_role),
@ -108,6 +109,7 @@ options:
- It makes sense to use C(yes) only when SQL injections via the parameters are possible. - It makes sense to use C(yes) only when SQL injections via the parameters are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
seealso: seealso:
- name: PostgreSQL languages - name: PostgreSQL languages
description: General information about PostgreSQL languages. description: General information about PostgreSQL languages.

View file

@ -73,6 +73,7 @@ options:
- It makes sense to use C(yes) only when SQL injections via the parameters are possible. - It makes sense to use C(yes) only when SQL injections via the parameters are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
seealso: seealso:
- module: postgresql_user - module: postgresql_user
- module: postgresql_privs - module: postgresql_privs

View file

@ -71,6 +71,7 @@ options:
- It makes sense to use C(yes) only when SQL injections via the parameters are possible. - It makes sense to use C(yes) only when SQL injections via the parameters are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
seealso: seealso:
- module: postgresql_user - module: postgresql_user
- module: postgresql_privs - module: postgresql_privs

View file

@ -27,12 +27,14 @@ options:
- Permissions checking for SQL commands is carried out as though - Permissions checking for SQL commands is carried out as though
the session_role were the one that had logged in originally. the session_role were the one that had logged in originally.
type: str type: str
version_added: '0.2.0'
trust_input: trust_input:
description: description:
- If C(no), check whether a value of I(session_role) is potentially dangerous. - If C(no), check whether a value of I(session_role) is potentially dangerous.
- It does make sense to use C(yes) only when SQL injections via I(session_role) are possible. - It does make sense to use C(yes) only when SQL injections via I(session_role) are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
seealso: seealso:
- module: postgresql_info - module: postgresql_info
author: author:

View file

@ -160,6 +160,7 @@ options:
- It makes sense to use C(yes) only when SQL injections via the parameters are possible. - It makes sense to use C(yes) only when SQL injections via the parameters are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
notes: notes:
- Parameters that accept comma separated lists (I(privs), I(objs), I(roles)) - Parameters that accept comma separated lists (I(privs), I(objs), I(roles))

View file

@ -64,6 +64,7 @@ options:
- Permissions checking for SQL commands is carried out as though - Permissions checking for SQL commands is carried out as though
the session_role were the one that had logged in originally. the session_role were the one that had logged in originally.
type: str type: str
version_added: '0.2.0'
trust_input: trust_input:
description: description:
- If C(no), check whether values of parameters I(name), I(tables), I(owner), - If C(no), check whether values of parameters I(name), I(tables), I(owner),
@ -71,6 +72,7 @@ options:
- It makes sense to use C(yes) only when SQL injections via the parameters are possible. - It makes sense to use C(yes) only when SQL injections via the parameters are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
notes: notes:
- PostgreSQL version must be 10 or greater. - PostgreSQL version must be 10 or greater.
seealso: seealso:

View file

@ -67,12 +67,14 @@ options:
- Set the client encoding for the current session (e.g. C(UTF-8)). - Set the client encoding for the current session (e.g. C(UTF-8)).
- The default is the encoding defined by the database. - The default is the encoding defined by the database.
type: str type: str
version_added: '0.2.0'
trust_input: trust_input:
description: description:
- If C(no), check whether a value of I(session_role) is potentially dangerous. - If C(no), check whether a value of I(session_role) is potentially dangerous.
- It does make sense to use C(yes) only when SQL injections via I(session_role) are possible. - It does make sense to use C(yes) only when SQL injections via I(session_role) are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
seealso: seealso:
- module: postgresql_db - module: postgresql_db
author: author:

View file

@ -71,6 +71,7 @@ options:
- It makes sense to use C(yes) only when SQL injections via the parameters are possible. - It makes sense to use C(yes) only when SQL injections via the parameters are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
seealso: seealso:
- name: PostgreSQL schemas - name: PostgreSQL schemas
description: General information about PostgreSQL schemas. description: General information about PostgreSQL schemas.

View file

@ -136,6 +136,7 @@ options:
- It makes sense to use C(yes) only when SQL injections via the parameters are possible. - It makes sense to use C(yes) only when SQL injections via the parameters are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
notes: notes:
- If you do not pass db parameter, sequence will be created in the database - If you do not pass db parameter, sequence will be created in the database
named postgres. named postgres.

View file

@ -59,6 +59,7 @@ options:
- It does make sense to use C(yes) only when SQL injections are possible. - It does make sense to use C(yes) only when SQL injections are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
notes: notes:
- Supported version of PostgreSQL is 9.4 and later. - Supported version of PostgreSQL is 9.4 and later.
- Pay attention, change setting with 'postmaster' context can return changed is true - Pay attention, change setting with 'postmaster' context can return changed is true

View file

@ -72,6 +72,7 @@ options:
- It sense to use C(no) only when SQL injections via I(session_role) are possible. - It sense to use C(no) only when SQL injections via I(session_role) are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
notes: notes:
- Physical replication slots were introduced to PostgreSQL with version 9.4, - Physical replication slots were introduced to PostgreSQL with version 9.4,

View file

@ -14,6 +14,7 @@ module: postgresql_subscription
short_description: Add, update, or remove PostgreSQL subscription short_description: Add, update, or remove PostgreSQL subscription
description: description:
- Add, update, or remove PostgreSQL subscription. - Add, update, or remove PostgreSQL subscription.
version_added: '0.2.0'
options: options:
name: name:
@ -82,6 +83,7 @@ options:
- Permissions checking for SQL commands is carried out as though - Permissions checking for SQL commands is carried out as though
the session_role were the one that had logged in originally. the session_role were the one that had logged in originally.
type: str type: str
version_added: '0.2.0'
trust_input: trust_input:
description: description:
- If C(no), check whether values of parameters I(name), I(publications), I(owner), - If C(no), check whether values of parameters I(name), I(publications), I(owner),
@ -89,6 +91,7 @@ options:
- It makes sense to use C(yes) only when SQL injections via the parameters are possible. - It makes sense to use C(yes) only when SQL injections via the parameters are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
notes: notes:
- PostgreSQL version must be 10 or greater. - PostgreSQL version must be 10 or greater.

View file

@ -99,6 +99,7 @@ options:
- It makes sense to use C(yes) only when SQL injections are possible. - It makes sense to use C(yes) only when SQL injections are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
notes: notes:
- If you do not pass db parameter, tables will be created in the database - If you do not pass db parameter, tables will be created in the database
named postgres. named postgres.

View file

@ -76,6 +76,7 @@ options:
- It makes sense to use C(yes) only when SQL injections via the parameters are possible. - It makes sense to use C(yes) only when SQL injections via the parameters are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
notes: notes:
- I(state=absent) and I(state=present) (the second one if the tablespace doesn't exist) do not - I(state=absent) and I(state=present) (the second one if the tablespace doesn't exist) do not

View file

@ -141,6 +141,7 @@ options:
description: description:
- Add a comment on the user (equal to the COMMENT ON ROLE statement result). - Add a comment on the user (equal to the COMMENT ON ROLE statement result).
type: str type: str
version_added: '0.2.0'
trust_input: trust_input:
description: description:
- If C(no), check whether values of parameters I(name), I(password), I(privs), I(expires), - If C(no), check whether values of parameters I(name), I(password), I(privs), I(expires),
@ -148,6 +149,7 @@ options:
- It makes sense to use C(yes) only when SQL injections via the parameters are possible. - It makes sense to use C(yes) only when SQL injections via the parameters are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
notes: notes:
- The module creates a user (role) with login privilege by default. - The module creates a user (role) with login privilege by default.
Use NOLOGIN role_attr_flags to change this behaviour. Use NOLOGIN role_attr_flags to change this behaviour.

View file

@ -13,6 +13,7 @@ module: postgresql_user_obj_stat_info
short_description: Gather statistics about PostgreSQL user objects short_description: Gather statistics about PostgreSQL user objects
description: description:
- Gathers statistics about PostgreSQL user objects. - Gathers statistics about PostgreSQL user objects.
version_added: '0.2.0'
options: options:
filter: filter:
description: description:
@ -45,6 +46,7 @@ options:
- It only makes sense to use C(no) only when SQL injections via I(session_role) are possible. - It only makes sense to use C(no) only when SQL injections via I(session_role) are possible.
type: bool type: bool
default: yes default: yes
version_added: '0.2.0'
notes: notes:
- C(size) and C(total_size) returned values are presented in bytes. - C(size) and C(total_size) returned values are presented in bytes.

View file

@ -15,8 +15,9 @@ short_description: Generate ISO file with specified files or folders
description: description:
- This module is used to generate ISO file with specified path of files. - This module is used to generate ISO file with specified path of files.
author: author:
- Diane Wang(@Tomorrow9) <dianew@vmware.com> - Diane Wang (@Tomorrow9) <dianew@vmware.com>
requirements: ["pycdlib", "python >= 2.7"] requirements: ["pycdlib", "python >= 2.7"]
version_added: '0.2.0'
options: options:
src_files: src_files:

View file

@ -89,6 +89,7 @@ options:
description: description:
- Default home directory of the user. - Default home directory of the user.
type: str type: str
version_added: '0.2.0'
extends_documentation_fragment: extends_documentation_fragment:
- community.general.ipa.documentation - community.general.ipa.documentation

View file

@ -24,11 +24,13 @@ options:
- Airbrake PROJECT_ID - Airbrake PROJECT_ID
required: false required: false
type: str type: str
version_added: '0.2.0'
project_key: project_key:
description: description:
- Airbrake PROJECT_KEY. - Airbrake PROJECT_KEY.
required: false required: false
type: str type: str
version_added: '0.2.0'
environment: environment:
description: description:
- The airbrake environment name, typically 'production', 'staging', etc. - The airbrake environment name, typically 'production', 'staging', etc.

View file

@ -68,6 +68,7 @@ options:
- Message about the deployment. - Message about the deployment.
- C(message) alias is deprecated in Ansible 2.10, since it is used internally by Ansible Core Engine. - C(message) alias is deprecated in Ansible 2.10, since it is used internally by Ansible Core Engine.
aliases: ['message'] aliases: ['message']
version_added: '0.2.0'
# informational: requirements for nodes # informational: requirements for nodes
requirements: [ ] requirements: [ ]

View file

@ -29,6 +29,7 @@ options:
- This value can also be set with the C(DATADOG_HOST) environment variable. - This value can also be set with the C(DATADOG_HOST) environment variable.
required: false required: false
type: str type: str
version_added: '0.2.0'
app_key: app_key:
description: description:
- Your Datadog app key. - Your Datadog app key.

View file

@ -57,6 +57,7 @@ options:
start: start:
description: description:
- When downtime should start, in time_t format (epoch seconds). - When downtime should start, in time_t format (epoch seconds).
version_added: '0.2.0'
minutes: minutes:
description: description:
- Minutes to schedule downtime for. - Minutes to schedule downtime for.

View file

@ -25,6 +25,7 @@ options:
- "You can obtain your API token from the bottom of the Cloudflare 'My Account' page, found here: U(https://dash.cloudflare.com/)" - "You can obtain your API token from the bottom of the Cloudflare 'My Account' page, found here: U(https://dash.cloudflare.com/)"
type: str type: str
required: false required: false
version_added: '0.2.0'
account_api_key: account_api_key:
description: description:
- Account API key. - Account API key.

View file

@ -11,6 +11,7 @@ __metaclass__ = type
DOCUMENTATION = r''' DOCUMENTATION = r'''
--- ---
module: hetzner_firewall module: hetzner_firewall
version_added: '0.2.0'
short_description: Manage Hetzner's dedicated server firewall short_description: Manage Hetzner's dedicated server firewall
author: author:
- Felix Fontein (@felixfontein) - Felix Fontein (@felixfontein)

View file

@ -11,6 +11,7 @@ __metaclass__ = type
DOCUMENTATION = r''' DOCUMENTATION = r'''
--- ---
module: hetzner_firewall_info module: hetzner_firewall_info
version_added: '0.2.0'
short_description: Manage Hetzner's dedicated server firewall short_description: Manage Hetzner's dedicated server firewall
author: author:
- Felix Fontein (@felixfontein) - Felix Fontein (@felixfontein)

View file

@ -12,6 +12,7 @@ module: ipwcli_dns
short_description: Manage DNS Records for Ericsson IPWorks via ipwcli short_description: Manage DNS Records for Ericsson IPWorks via ipwcli
version_added: '0.2.0'
description: description:
- "Manage DNS records for the Ericsson IPWorks DNS server. The module will use the ipwcli to deploy the DNS records." - "Manage DNS records for the Ericsson IPWorks DNS server. The module will use the ipwcli to deploy the DNS records."

View file

@ -32,6 +32,7 @@ notes:
rules. This should work out in most cases, but it is theoretically rules. This should work out in most cases, but it is theoretically
possible to see spurious changes when target and actual values are possible to see spurious changes when target and actual values are
semantically identical but lexically distinct. semantically identical but lexically distinct.
version_added: '0.2.0'
author: author:
- Jiri Tyr (@jtyr) - Jiri Tyr (@jtyr)
- Alexander Korinek (@noles) - Alexander Korinek (@noles)

View file

@ -11,6 +11,7 @@ __metaclass__ = type
DOCUMENTATION = r""" DOCUMENTATION = r"""
--- ---
module: ldap_search module: ldap_search
version_added: '0.2.0'
short_description: Search for entries in a LDAP server short_description: Search for entries in a LDAP server
description: description:
- Return the results of an LDAP search. - Return the results of an LDAP search.

View file

@ -84,6 +84,7 @@ options:
required: false required: false
aliases: aliases:
- add - add
version_added: '0.2.0'
remove: remove:
description: description:
- If user wants to remove the ipv4 address from an existing host record. - If user wants to remove the ipv4 address from an existing host record.
@ -93,6 +94,7 @@ options:
required: false required: false
aliases: aliases:
- remove - remove
version_added: '0.2.0'
ipv6addrs: ipv6addrs:
description: description:
- Configures the IPv6 addresses for the host record. This argument - Configures the IPv6 addresses for the host record. This argument

View file

@ -38,6 +38,7 @@ options:
- Specify the name of application name which is sending the log to syslog. - Specify the name of application name which is sending the log to syslog.
type: str type: str
default: 'ansible_syslogger' default: 'ansible_syslogger'
version_added: '0.2.0'
author: author:
- Tim Rightnour (@garbled1) - Tim Rightnour (@garbled1)
''' '''
@ -67,6 +68,7 @@ ident:
returned: always returned: always
type: str type: str
sample: "ansible_syslogger" sample: "ansible_syslogger"
version_added: '0.2.0'
priority: priority:
description: Priority level description: Priority level
returned: always returned: always

View file

@ -41,6 +41,7 @@ options:
- See supported version ranges on U(https://cwiki.apache.org/confluence/display/MAVENOLD/Dependency+Mediation+and+Conflict+Resolution) - See supported version ranges on U(https://cwiki.apache.org/confluence/display/MAVENOLD/Dependency+Mediation+and+Conflict+Resolution)
- The range type "(,1.0],[1.2,)" and "(,1.1),(1.1,)" is not supported. - The range type "(,1.0],[1.2,)" and "(,1.1),(1.1,)" is not supported.
- Mutually exclusive with I(version). - Mutually exclusive with I(version).
version_added: '0.2.0'
classifier: classifier:
description: description:
- The maven classifier coordinate - The maven classifier coordinate
@ -74,6 +75,7 @@ options:
upon initial request. upon initial request.
default: 'no' default: 'no'
type: bool type: bool
version_added: '0.2.0'
dest: dest:
description: description:
- The path where the artifact should be written to - The path where the artifact should be written to

View file

@ -69,6 +69,7 @@ options:
- Option flags to upgrade. - Option flags to upgrade.
type: list type: list
elements: str elements: str
version_added: '0.2.0'
notes: notes:
- When used with a `loop:` each package will be processed individually, - When used with a `loop:` each package will be processed individually,
it is much more efficient to pass the list directly to the `name` option. it is much more efficient to pass the list directly to the `name` option.
@ -140,17 +141,17 @@ msg:
unchanged_pkgs: unchanged_pkgs:
description: description:
- List of package names which are unchanged after module run - List of package names which are unchanged after module run
- "Added in version 2.10"
returned: success returned: success
type: list type: list
sample: ["awscli", "ag"] sample: ["awscli", "ag"]
version_added: '0.2.0'
changed_pkgs: changed_pkgs:
description: description:
- List of package names which are changed after module run - List of package names which are changed after module run
- "Added in version 2.10"
returned: success returned: success
type: list type: list
sample: ['git', 'git-cola'] sample: ['git', 'git-cola']
version_added: '0.2.0'
''' '''
import os.path import os.path

View file

@ -14,6 +14,7 @@ module: mas
short_description: Manage Mac App Store applications with mas-cli short_description: Manage Mac App Store applications with mas-cli
description: description:
- Installs, uninstalls and updates macOS applications from the Mac App Store using the C(mas-cli). - Installs, uninstalls and updates macOS applications from the Mac App Store using the C(mas-cli).
version_added: '0.2.0'
author: author:
- Michael Heap (@mheap) - Michael Heap (@mheap)
- Lukas Bestle (@lukasbestle) - Lukas Bestle (@lukasbestle)

View file

@ -50,6 +50,7 @@ options:
can modify traffic between the module and the site. can modify traffic between the module and the site.
type: bool type: bool
default: true default: true
version_added: '0.2.0'
''' '''
EXAMPLES = ''' EXAMPLES = '''

View file

@ -54,6 +54,7 @@ options:
upgrades and installations will fail when xbps is not up to date. upgrades and installations will fail when xbps is not up to date.
type: bool type: bool
default: 'yes' default: 'yes'
version_added: '0.2.0'
''' '''
EXAMPLES = ''' EXAMPLES = '''

View file

@ -87,6 +87,7 @@ options:
required: false required: false
default: "no" default: "no"
type: bool type: bool
version_added: '0.2.0'
update_cache: update_cache:
description: description:
- Run the equivalent of C(zypper refresh) before the operation. Disabled in check mode. - Run the equivalent of C(zypper refresh) before the operation. Disabled in check mode.
@ -112,12 +113,14 @@ options:
default: false default: false
description: description:
- Adds C(--allow_vendor_change) option to I(zypper) dist-upgrade command. - Adds C(--allow_vendor_change) option to I(zypper) dist-upgrade command.
version_added: '0.2.0'
replacefiles: replacefiles:
type: bool type: bool
required: false required: false
default: false default: false
description: description:
- Adds C(--replacefiles) option to I(zypper) install/update command. - Adds C(--replacefiles) option to I(zypper) install/update command.
version_added: '0.2.0'
notes: notes:
- When used with a `loop:` each package will be processed individually, - When used with a `loop:` each package will be processed individually,
it is much more efficient to pass the list directly to the `name` option. it is much more efficient to pass the list directly to the `name` option.

View file

@ -51,6 +51,7 @@ options:
description: description:
- The ID of the System, Manager or Chassis to modify - The ID of the System, Manager or Chassis to modify
type: str type: str
version_added: '0.2.0'
author: "Jose Delarosa (@jose-delarosa)" author: "Jose Delarosa (@jose-delarosa)"
''' '''

View file

@ -60,6 +60,7 @@ options:
- dictionary of iDRAC attribute name and value pairs to update - dictionary of iDRAC attribute name and value pairs to update
default: {} default: {}
type: 'dict' type: 'dict'
version_added: '0.2.0'
timeout: timeout:
description: description:
- Timeout in seconds for URL requests to iDRAC controller - Timeout in seconds for URL requests to iDRAC controller
@ -70,6 +71,7 @@ options:
description: description:
- The ID of the System, Manager or Chassis to modify - The ID of the System, Manager or Chassis to modify
type: str type: str
version_added: '0.2.0'
author: "Jose Delarosa (@jose-delarosa)" author: "Jose Delarosa (@jose-delarosa)"
''' '''

View file

@ -93,37 +93,44 @@ options:
description: description:
- new update user name for account_username - new update user name for account_username
type: str type: str
version_added: '0.2.0'
account_properties: account_properties:
required: false required: false
description: description:
- properties of account service to update - properties of account service to update
type: dict type: dict
version_added: '0.2.0'
resource_id: resource_id:
required: false required: false
description: description:
- The ID of the System, Manager or Chassis to modify - The ID of the System, Manager or Chassis to modify
type: str type: str
version_added: '0.2.0'
update_image_uri: update_image_uri:
required: false required: false
description: description:
- The URI of the image for the update - The URI of the image for the update
type: str type: str
version_added: '0.2.0'
update_protocol: update_protocol:
required: false required: false
description: description:
- The protocol for the update - The protocol for the update
type: str type: str
version_added: '0.2.0'
update_targets: update_targets:
required: false required: false
description: description:
- The list of target resource URIs to apply the update to - The list of target resource URIs to apply the update to
type: list type: list
elements: str elements: str
version_added: '0.2.0'
update_creds: update_creds:
required: false required: false
description: description:
- The credentials for retrieving the update image - The credentials for retrieving the update image
type: dict type: dict
version_added: '0.2.0'
suboptions: suboptions:
username: username:
required: false required: false
@ -140,6 +147,7 @@ options:
description: description:
- The options for VirtualMedia commands - The options for VirtualMedia commands
type: dict type: dict
version_added: '0.2.0'
suboptions: suboptions:
media_types: media_types:
required: false required: false

View file

@ -60,6 +60,7 @@ options:
- dictionary of BIOS attributes to update - dictionary of BIOS attributes to update
default: {} default: {}
type: dict type: dict
version_added: '0.2.0'
timeout: timeout:
description: description:
- Timeout in seconds for URL requests to OOB controller - Timeout in seconds for URL requests to OOB controller
@ -71,27 +72,32 @@ options:
- list of BootOptionReference strings specifying the BootOrder - list of BootOptionReference strings specifying the BootOrder
default: [] default: []
type: list type: list
version_added: '0.2.0'
network_protocols: network_protocols:
required: false required: false
description: description:
- setting dict of manager services to update - setting dict of manager services to update
type: dict type: dict
version_added: '0.2.0'
resource_id: resource_id:
required: false required: false
description: description:
- The ID of the System, Manager or Chassis to modify - The ID of the System, Manager or Chassis to modify
type: str type: str
version_added: '0.2.0'
nic_addr: nic_addr:
required: false required: false
description: description:
- EthernetInterface Address string on OOB controller - EthernetInterface Address string on OOB controller
default: 'null' default: 'null'
type: str type: str
version_added: '0.2.0'
nic_config: nic_config:
required: false required: false
description: description:
- setting dict of EthernetInterface on OOB controller - setting dict of EthernetInterface on OOB controller
type: dict type: dict
version_added: '0.2.0'
author: "Jose Delarosa (@jose-delarosa)" author: "Jose Delarosa (@jose-delarosa)"
''' '''

View file

@ -22,6 +22,7 @@ options:
- The base URL of the GitHub API - The base URL of the GitHub API
required: false required: false
type: str type: str
version_added: '0.2.0'
default: https://api.github.com default: https://api.github.com
owner: owner:
description: description:

View file

@ -57,6 +57,7 @@ options:
description: description:
- Branch name of wildcard to trigger hook on push events - Branch name of wildcard to trigger hook on push events
type: str type: str
version_added: '0.2.0'
issues_events: issues_events:
description: description:
- Trigger hook on issues events. - Trigger hook on issues events.

View file

@ -12,6 +12,7 @@ DOCUMENTATION = r'''
--- ---
module: dpkg_divert module: dpkg_divert
short_description: Override a debian package's version of a file short_description: Override a debian package's version of a file
version_added: '0.2.0'
author: author:
- quidame (@quidame) - quidame (@quidame)
description: description:

View file

@ -41,6 +41,7 @@ options:
- Trust imported cert as CAcert. - Trust imported cert as CAcert.
type: bool type: bool
default: False default: False
version_added: '0.2.0'
pkcs12_path: pkcs12_path:
description: description:
- Local path to load PKCS12 keystore from. - Local path to load PKCS12 keystore from.

View file

@ -32,7 +32,7 @@ options:
- Pass phrase for reading the private key, if required. - Pass phrase for reading the private key, if required.
type: str type: str
required: false required: false
version_added: "2.10" version_added: '0.2.0'
password: password:
description: description:
- Password that should be used to secure the key store. - Password that should be used to secure the key store.

View file

@ -12,6 +12,7 @@ module: lbu
short_description: Local Backup Utility for Alpine Linux short_description: Local Backup Utility for Alpine Linux
version_added: '0.2.0'
description: description:
- Manage Local Backup Utility of Alpine Linux in run-from-RAM mode - Manage Local Backup Utility of Alpine Linux in run-from-RAM mode

View file

@ -45,6 +45,7 @@ options:
- If C(yes), resize the physical volume to the maximum available size. - If C(yes), resize the physical volume to the maximum available size.
type: bool type: bool
default: false default: false
version_added: '0.2.0'
vg_options: vg_options:
description: description:
- Additional options to pass to C(vgcreate) when creating the volume group. - Additional options to pass to C(vgcreate) when creating the volume group.

View file

@ -39,6 +39,7 @@ options:
description: description:
- Use a specific make binary. - Use a specific make binary.
type: path type: path
version_added: '0.2.0'
''' '''
EXAMPLES = r''' EXAMPLES = r'''

View file

@ -94,7 +94,7 @@ options:
description: description:
- If specified and the partition does not exist, will set filesystem type to given partition. - If specified and the partition does not exist, will set filesystem type to given partition.
type: str type: str
version_added: '2.10' version_added: '0.2.0'
notes: notes:
- When fetching information about a new disk and when the version of 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 installed on the system is before version 3.1, the module queries the kernel

View file

@ -136,6 +136,7 @@ options:
compatible with I(interface_out) for routed rules. compatible with I(interface_out) for routed rules.
type: str type: str
aliases: [ if_in ] aliases: [ if_in ]
version_added: '0.2.0'
interface_out: interface_out:
description: description:
- Specify output interface for the rule. This is mutually - Specify output interface for the rule. This is mutually
@ -143,6 +144,7 @@ options:
compatible with I(interface_in) for routed rules. compatible with I(interface_in) for routed rules.
type: str type: str
aliases: [ if_out ] aliases: [ if_out ]
version_added: '0.2.0'
route: route:
description: description:
- Apply the rule to routed/forwarded packets. - Apply the rule to routed/forwarded packets.

View file

@ -108,6 +108,7 @@ options:
description: description:
- Query JIRA in JQL Syntax, e.g. 'CMDB Hostname'='test.example.com'. - Query JIRA in JQL Syntax, e.g. 'CMDB Hostname'='test.example.com'.
type: str type: str
version_added: '0.2.0'
maxresults: maxresults:
required: false required: false
@ -115,6 +116,7 @@ options:
- Limit the result of I(operation=search). If no value is specified, the default jira limit will be used. - Limit the result of I(operation=search). If no value is specified, the default jira limit will be used.
- Used when I(operation=search) only, ignored otherwise. - Used when I(operation=search) only, ignored otherwise.
type: int type: int
version_added: '0.2.0'
timeout: timeout:
required: false required: false

View file

@ -50,6 +50,24 @@ options:
- Sets the ACL policy content. - Sets the ACL policy content.
- ACL policy content is a YAML object as described in http://rundeck.org/docs/man5/aclpolicy.html. - ACL policy content is a YAML object as described in http://rundeck.org/docs/man5/aclpolicy.html.
- It can be a YAML string or a pure Ansible inventory YAML object. - It can be a YAML string or a pure Ansible inventory YAML object.
client_cert:
version_added: '0.2.0'
client_key:
version_added: '0.2.0'
force:
version_added: '0.2.0'
force_basic_auth:
version_added: '0.2.0'
http_agent:
version_added: '0.2.0'
url_password:
version_added: '0.2.0'
url_username:
version_added: '0.2.0'
use_proxy:
version_added: '0.2.0'
validate_certs:
version_added: '0.2.0'
extends_documentation_fragment: url extends_documentation_fragment: url
''' '''

Some files were not shown because too many files have changed in this diff Show more