From 195beebcb4d25eeb32dfe251cb4993a99e865982 Mon Sep 17 00:00:00 2001 From: John R Barker Date: Tue, 16 Jan 2018 12:18:51 +0000 Subject: [PATCH] Module DOCUMENTATION should match argspec (#34895) * Module DOCUMENTATION should match argspec Large update of many modules so that DOCUMENTATION option name and aliases match those defined in the argspec. Issues identified by https://github.com/ansible/ansible/pull/34809 In addition to many typos and missing aliases, the following notable changes were made: * Create `module_docs_fragments/url.py` for `url_argument_spec` * `dellos*_command` shouldn't have ever had `waitfor` (was incorrectly copied) * `ce_aaa_server_host.py` `s/raduis_server_type/radius_server_type/g` * `Junos_lldp` enable should be part of `state`. --- .../modules/cloud/amazon/_ec2_ami_find.py | 2 + .../modules/cloud/amazon/aws_acm_facts.py | 4 +- .../modules/cloud/amazon/aws_api_gateway.py | 1 + .../amazon/aws_direct_connect_connection.py | 9 ++- .../amazon/aws_direct_connect_gateway.py | 3 + ...s_direct_connect_link_aggregation_group.py | 3 + lib/ansible/modules/cloud/amazon/aws_s3.py | 4 +- .../modules/cloud/amazon/aws_s3_cors.py | 1 + .../modules/cloud/amazon/aws_waf_facts.py | 4 +- .../modules/cloud/amazon/cloudfront_facts.py | 6 +- .../cloud/amazon/cloudwatchevent_rule.py | 1 + lib/ansible/modules/cloud/amazon/ec2_key.py | 1 + .../modules/cloud/amazon/ec2_lc_find.py | 2 + .../cloud/amazon/ec2_metadata_facts.py | 2 + .../cloud/amazon/ec2_vpc_dhcp_option.py | 4 +- .../cloud/amazon/ec2_vpc_dhcp_option_facts.py | 2 +- .../cloud/amazon/ec2_vpc_endpoint_facts.py | 4 +- .../modules/cloud/amazon/ec2_vpc_nacl.py | 4 +- .../modules/cloud/amazon/ec2_vpc_peer.py | 4 +- .../cloud/amazon/ec2_vpc_peering_facts.py | 4 +- .../modules/cloud/amazon/ec2_vpc_vgw.py | 1 - .../modules/cloud/amazon/ec2_vpc_vpn.py | 3 + lib/ansible/modules/cloud/amazon/ecs_ecr.py | 4 +- lib/ansible/modules/cloud/amazon/efs_facts.py | 3 +- .../modules/cloud/amazon/elasticache_facts.py | 4 +- .../amazon/elasticache_parameter_group.py | 3 + .../cloud/amazon/elasticache_snapshot.py | 3 + .../modules/cloud/amazon/execute_lambda.py | 1 + lib/ansible/modules/cloud/amazon/iam.py | 4 +- lib/ansible/modules/cloud/amazon/iam_group.py | 1 + .../cloud/amazon/iam_managed_policy.py | 3 + lib/ansible/modules/cloud/amazon/iam_role.py | 1 + .../modules/cloud/amazon/iam_role_facts.py | 3 +- .../modules/cloud/amazon/lambda_alias.py | 4 +- .../modules/cloud/amazon/lambda_event.py | 2 +- .../modules/cloud/amazon/lambda_facts.py | 4 +- .../modules/cloud/amazon/lambda_policy.py | 4 +- lib/ansible/modules/cloud/amazon/lightsail.py | 4 +- .../modules/cloud/amazon/rds_param_group.py | 1 + lib/ansible/modules/cloud/amazon/redshift.py | 4 +- .../cloud/amazon/redshift_subnet_group.py | 4 +- .../modules/cloud/amazon/route53_facts.py | 4 +- lib/ansible/modules/cloud/amazon/sns.py | 4 +- lib/ansible/modules/cloud/amazon/sns_topic.py | 4 +- .../cloud/cloudstack/cs_network_offering.py | 3 +- .../cloud/digital_ocean/digital_ocean.py | 1 + .../digital_ocean_certificate.py | 1 + .../digital_ocean/digital_ocean_domain.py | 3 +- .../digital_ocean/digital_ocean_sshkey.py | 1 + .../cloud/digital_ocean/digital_ocean_tag.py | 1 + .../modules/cloud/packet/packet_device.py | 6 -- .../modules/cloud/rackspace/rax_cdb.py | 4 +- .../cloud/rackspace/rax_cdb_database.py | 4 +- .../modules/cloud/rackspace/rax_cdb_user.py | 4 +- .../modules/cloud/rackspace/rax_clb.py | 4 +- .../modules/cloud/rackspace/rax_clb_nodes.py | 4 +- .../modules/cloud/rackspace/rax_clb_ssl.py | 4 +- .../modules/cloud/rackspace/rax_dns.py | 4 +- .../modules/cloud/rackspace/rax_dns_record.py | 4 +- .../modules/cloud/rackspace/rax_files.py | 4 +- .../cloud/rackspace/rax_files_objects.py | 4 +- .../modules/cloud/rackspace/rax_queue.py | 4 +- .../cloud/rackspace/rax_scaling_group.py | 4 +- .../cloud/rackspace/rax_scaling_policy.py | 4 +- .../spotinst/spotinst_aws_elastigroup.py | 2 +- .../modules/clustering/openshift/_oc.py | 10 ++- .../modules/crypto/openssl_certificate.py | 6 +- .../database/postgresql/postgresql_privs.py | 2 + .../database/vertica/vertica_configuration.py | 1 + lib/ansible/modules/network/a10/a10_server.py | 5 +- .../modules/network/a10/a10_server_axapi3.py | 5 +- .../modules/network/a10/a10_service_group.py | 10 ++- .../modules/network/a10/a10_virtual_server.py | 9 ++- lib/ansible/modules/network/asa/asa_acl.py | 1 + .../network/cloudengine/ce_aaa_server_host.py | 70 +++++++++--------- .../network/dellos10/dellos10_command.py | 2 +- .../network/dellos6/dellos6_command.py | 2 +- .../network/dellos9/dellos9_command.py | 2 +- lib/ansible/modules/network/eos/eos_config.py | 1 + lib/ansible/modules/network/eos/eos_system.py | 1 + lib/ansible/modules/network/eos/eos_user.py | 3 +- .../modules/network/illumos/dladm_iptun.py | 2 +- .../modules/network/illumos/flowadm.py | 2 +- .../modules/network/illumos/ipadm_addrprop.py | 2 +- lib/ansible/modules/network/ios/ios_user.py | 4 +- .../modules/network/iosxr/iosxr_user.py | 6 +- .../modules/network/junos/junos_lldp.py | 6 -- .../modules/network/junos/junos_user.py | 3 +- .../network/nxos/_nxos_ip_interface.py | 5 ++ .../modules/network/nxos/_nxos_portchannel.py | 5 ++ lib/ansible/modules/network/nxos/nxos_acl.py | 7 +- .../modules/network/nxos/nxos_evpn_vni.py | 5 ++ lib/ansible/modules/network/nxos/nxos_igmp.py | 5 ++ .../network/nxos/nxos_igmp_interface.py | 5 ++ .../network/nxos/nxos_interface_ospf.py | 5 ++ lib/ansible/modules/network/nxos/nxos_ospf.py | 5 ++ .../modules/network/nxos/nxos_ospf_vrf.py | 5 ++ .../modules/network/nxos/nxos_rollback.py | 5 ++ lib/ansible/modules/network/nxos/nxos_user.py | 6 +- lib/ansible/modules/network/nxos/nxos_vrrp.py | 5 ++ .../network/ordnance/ordnance_config.py | 2 +- .../modules/network/ovs/openvswitch_db.py | 2 +- .../modules/network/vyos/vyos_system.py | 2 +- lib/ansible/modules/network/vyos/vyos_user.py | 4 +- lib/ansible/modules/notification/mail.py | 1 + lib/ansible/modules/notification/nexmo.py | 2 + .../modules/packaging/language/composer.py | 2 +- lib/ansible/modules/packaging/os/apt.py | 1 + lib/ansible/modules/packaging/os/pulp_repo.py | 3 +- lib/ansible/modules/packaging/os/urpmi.py | 1 + .../modules/remote_management/imc/imc_rest.py | 2 +- .../remote_management/ucs/ucs_wwn_pool.py | 2 +- .../source_control/github_deploy_key.py | 1 + .../storage/netapp/netapp_e_hostgroup.py | 2 +- lib/ansible/modules/system/gluster_volume.py | 2 +- lib/ansible/modules/system/selinux.py | 1 + .../web_infrastructure/django_manage.py | 2 +- .../web_infrastructure/jenkins_plugin.py | 2 + .../modules/web_infrastructure/jira.py | 1 - lib/ansible/utils/module_docs_fragments/f5.py | 1 + .../utils/module_docs_fragments/netapp.py | 2 + .../utils/module_docs_fragments/url.py | 72 +++++++++++++++++++ .../utils/module_docs_fragments/vca.py | 2 +- 123 files changed, 406 insertions(+), 132 deletions(-) create mode 100644 lib/ansible/utils/module_docs_fragments/url.py diff --git a/lib/ansible/modules/cloud/amazon/_ec2_ami_find.py b/lib/ansible/modules/cloud/amazon/_ec2_ami_find.py index 324405647a..9c7c5d8c45 100644 --- a/lib/ansible/modules/cloud/amazon/_ec2_ami_find.py +++ b/lib/ansible/modules/cloud/amazon/_ec2_ami_find.py @@ -158,6 +158,8 @@ options: choices: ['success', 'fail'] default: 'success' required: false +extends_documentation_fragment: + - aws requirements: - "python >= 2.6" - boto diff --git a/lib/ansible/modules/cloud/amazon/aws_acm_facts.py b/lib/ansible/modules/cloud/amazon/aws_acm_facts.py index 0ad2244824..5a606fc5b2 100644 --- a/lib/ansible/modules/cloud/amazon/aws_acm_facts.py +++ b/lib/ansible/modules/cloud/amazon/aws_acm_facts.py @@ -25,7 +25,9 @@ requirements: - boto3 author: - Will Thames (@willthames) -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/aws_api_gateway.py b/lib/ansible/modules/cloud/amazon/aws_api_gateway.py index 79e469c4aa..880dc610bf 100644 --- a/lib/ansible/modules/cloud/amazon/aws_api_gateway.py +++ b/lib/ansible/modules/cloud/amazon/aws_api_gateway.py @@ -63,6 +63,7 @@ author: - 'Michael De La Rue (@mikedlr)' extends_documentation_fragment: - aws + - ec2 notes: - A future version of this module will probably use tags or another ID so that an API can be create only once. diff --git a/lib/ansible/modules/cloud/amazon/aws_direct_connect_connection.py b/lib/ansible/modules/cloud/amazon/aws_direct_connect_connection.py index 04bc5b45e6..0524385d9e 100644 --- a/lib/ansible/modules/cloud/amazon/aws_direct_connect_connection.py +++ b/lib/ansible/modules/cloud/amazon/aws_direct_connect_connection.py @@ -17,6 +17,9 @@ description: The connection may later be associated or disassociated with a link aggregation group. version_added: "2.4" author: "Sloane Hertel (@s-hertel)" +extends_documentation_fragment: + - aws + - ec2 requirements: - boto3 - botocore @@ -36,7 +39,7 @@ options: description: - The ID of the Direct Connect connection. I(name) or I(connection_id) is required to recreate or delete a connection. Modifying attributes of a - connection with I(force_update) will result in a new Direct Connect connection ID. + connection with I(forced_update) will result in a new Direct Connect connection ID. location: description: - Where the Direct Connect connection is located. Required when I(state=present). @@ -50,7 +53,7 @@ options: description: - The ID of the link aggregation group you want to associate with the connection. This is optional in case a stand-alone connection is desired. - force_update: + forced_update: description: - To modify bandwidth or location the connection will need to be deleted and recreated. By default this will not happen - this option must be set to True. @@ -80,7 +83,7 @@ aws_direct_connect_connection: name: ansible-test-connection location: EqDC2 bandwidth: 10Gbps - force_update: True + forced_update: True # delete the connection aws_direct_connect_connection: diff --git a/lib/ansible/modules/cloud/amazon/aws_direct_connect_gateway.py b/lib/ansible/modules/cloud/amazon/aws_direct_connect_gateway.py index 04e7283090..85df59785e 100644 --- a/lib/ansible/modules/cloud/amazon/aws_direct_connect_gateway.py +++ b/lib/ansible/modules/cloud/amazon/aws_direct_connect_gateway.py @@ -21,6 +21,9 @@ description: - Deletes AWS Direct Connect Gateway - Attaches Virtual Gateways to Direct Connect Gateway - Detaches Virtual Gateways to Direct Connect Gateway +extends_documentation_fragment: + - aws + - ec2 requirements: [ boto3 ] options: state: diff --git a/lib/ansible/modules/cloud/amazon/aws_direct_connect_link_aggregation_group.py b/lib/ansible/modules/cloud/amazon/aws_direct_connect_link_aggregation_group.py index a849627c04..79de295a6b 100644 --- a/lib/ansible/modules/cloud/amazon/aws_direct_connect_link_aggregation_group.py +++ b/lib/ansible/modules/cloud/amazon/aws_direct_connect_link_aggregation_group.py @@ -15,6 +15,9 @@ description: - Create, delete, or modify a Direct Connect link aggregation group. version_added: "2.4" author: "Sloane Hertel (@s-hertel)" +extends_documentation_fragment: + - aws + - ec2 requirements: - boto3 - botocore diff --git a/lib/ansible/modules/cloud/amazon/aws_s3.py b/lib/ansible/modules/cloud/amazon/aws_s3.py index 83a62a2fd5..28e9261fc9 100644 --- a/lib/ansible/modules/cloud/amazon/aws_s3.py +++ b/lib/ansible/modules/cloud/amazon/aws_s3.py @@ -143,7 +143,9 @@ requirements: [ "boto3", "botocore" ] author: - "Lester Wade (@lwade)" - "Sloane Hertel (@s-hertel)" -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/aws_s3_cors.py b/lib/ansible/modules/cloud/amazon/aws_s3_cors.py index 4a0f55fa65..e41748bf9d 100644 --- a/lib/ansible/modules/cloud/amazon/aws_s3_cors.py +++ b/lib/ansible/modules/cloud/amazon/aws_s3_cors.py @@ -32,6 +32,7 @@ options: choices: [ 'present', 'absent' ] extends_documentation_fragment: - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/aws_waf_facts.py b/lib/ansible/modules/cloud/amazon/aws_waf_facts.py index 18f7ddc351..908d83f88a 100644 --- a/lib/ansible/modules/cloud/amazon/aws_waf_facts.py +++ b/lib/ansible/modules/cloud/amazon/aws_waf_facts.py @@ -21,7 +21,9 @@ options: author: - Mike Mochan (@mmochan) - Will Thames (@willthames) -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/cloudfront_facts.py b/lib/ansible/modules/cloud/amazon/cloudfront_facts.py index 9b0f97c732..da12f3530a 100644 --- a/lib/ansible/modules/cloud/amazon/cloudfront_facts.py +++ b/lib/ansible/modules/cloud/amazon/cloudfront_facts.py @@ -93,7 +93,7 @@ options: I(domain_name_alias) to be specified. required: false default: false - streaming_distribution_configuration: + streaming_distribution_config: description: - Get the configuration information about a specified RTMP distribution. Requires I(distribution_id) or I(domain_name_alias) to be specified. @@ -214,11 +214,11 @@ streaming_distribution: I(distribution_id) or I(domain_name_alias) to be specified. returned: only if I(streaming_distribution) is true type: dict -streaming_distribution_configuration: +streaming_distribution_config: description: > Describes the streaming configuration information for the distribution. Requires I(distribution_id) or I(domain_name_alias) to be specified. - returned: only if I(streaming_distribution_configuration) is true + returned: only if I(streaming_distribution_config) is true type: dict summary: description: Gives a summary of distributions, streaming distributions and origin access identities. diff --git a/lib/ansible/modules/cloud/amazon/cloudwatchevent_rule.py b/lib/ansible/modules/cloud/amazon/cloudwatchevent_rule.py index 03f2ce6876..49ec93e7e0 100644 --- a/lib/ansible/modules/cloud/amazon/cloudwatchevent_rule.py +++ b/lib/ansible/modules/cloud/amazon/cloudwatchevent_rule.py @@ -20,6 +20,7 @@ description: version_added: "2.2" extends_documentation_fragment: - aws + - ec2 author: "Jim Dalton (@jsdalton) " requirements: - python >= 2.6 diff --git a/lib/ansible/modules/cloud/amazon/ec2_key.py b/lib/ansible/modules/cloud/amazon/ec2_key.py index d7033ccb24..4d13a64f86 100644 --- a/lib/ansible/modules/cloud/amazon/ec2_key.py +++ b/lib/ansible/modules/cloud/amazon/ec2_key.py @@ -55,6 +55,7 @@ options: extends_documentation_fragment: - aws + - ec2 requirements: [ boto3 ] author: - "Vincent Viallet (@zbal)" diff --git a/lib/ansible/modules/cloud/amazon/ec2_lc_find.py b/lib/ansible/modules/cloud/amazon/ec2_lc_find.py index d703571c8f..c126647367 100644 --- a/lib/ansible/modules/cloud/amazon/ec2_lc_find.py +++ b/lib/ansible/modules/cloud/amazon/ec2_lc_find.py @@ -51,6 +51,8 @@ options: requirements: - "python >= 2.6" - boto3 +extends_documentation_fragment: + - aws """ EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/ec2_metadata_facts.py b/lib/ansible/modules/cloud/amazon/ec2_metadata_facts.py index 7622aafb2d..959de2c5c0 100644 --- a/lib/ansible/modules/cloud/amazon/ec2_metadata_facts.py +++ b/lib/ansible/modules/cloud/amazon/ec2_metadata_facts.py @@ -26,6 +26,8 @@ description: The module must be called from within the EC2 instance itself. notes: - Parameters to filter on ec2_metadata_facts may be added later. +extends_documentation_fragment: + - url ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/ec2_vpc_dhcp_option.py b/lib/ansible/modules/cloud/amazon/ec2_vpc_dhcp_option.py index d33e9cb5dd..a439b6f14a 100644 --- a/lib/ansible/modules/cloud/amazon/ec2_vpc_dhcp_option.py +++ b/lib/ansible/modules/cloud/amazon/ec2_vpc_dhcp_option.py @@ -108,7 +108,9 @@ options: default: present choices: [ 'absent', 'present' ] version_added: "2.1" -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 requirements: - boto """ diff --git a/lib/ansible/modules/cloud/amazon/ec2_vpc_dhcp_option_facts.py b/lib/ansible/modules/cloud/amazon/ec2_vpc_dhcp_option_facts.py index 7b11f7d61d..4f32e79209 100644 --- a/lib/ansible/modules/cloud/amazon/ec2_vpc_dhcp_option_facts.py +++ b/lib/ansible/modules/cloud/amazon/ec2_vpc_dhcp_option_facts.py @@ -33,7 +33,7 @@ options: - Provide this value as a list required: false default: None - aliases: ['DhcpOptionsIds'] + aliases: ['DhcpOptionIds'] extends_documentation_fragment: - aws - ec2 diff --git a/lib/ansible/modules/cloud/amazon/ec2_vpc_endpoint_facts.py b/lib/ansible/modules/cloud/amazon/ec2_vpc_endpoint_facts.py index 27979744eb..61cdc4f18c 100644 --- a/lib/ansible/modules/cloud/amazon/ec2_vpc_endpoint_facts.py +++ b/lib/ansible/modules/cloud/amazon/ec2_vpc_endpoint_facts.py @@ -39,7 +39,9 @@ options: required: false default: None author: Karen Cheng(@Etherdaemon) -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/ec2_vpc_nacl.py b/lib/ansible/modules/cloud/amazon/ec2_vpc_nacl.py index fceff34b65..75bd846f0c 100644 --- a/lib/ansible/modules/cloud/amazon/ec2_vpc_nacl.py +++ b/lib/ansible/modules/cloud/amazon/ec2_vpc_nacl.py @@ -63,7 +63,9 @@ options: choices: ['present', 'absent'] default: present author: Mike Mochan(@mmochan) -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 requirements: [ botocore, boto3, json ] ''' diff --git a/lib/ansible/modules/cloud/amazon/ec2_vpc_peer.py b/lib/ansible/modules/cloud/amazon/ec2_vpc_peer.py index 0f6bdbf562..2dcde18eff 100644 --- a/lib/ansible/modules/cloud/amazon/ec2_vpc_peer.py +++ b/lib/ansible/modules/cloud/amazon/ec2_vpc_peer.py @@ -51,7 +51,9 @@ options: default: present choices: ['present', 'absent', 'accept', 'reject'] author: Mike Mochan(@mmochan) -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 requirements: [ botocore, boto3, json ] ''' diff --git a/lib/ansible/modules/cloud/amazon/ec2_vpc_peering_facts.py b/lib/ansible/modules/cloud/amazon/ec2_vpc_peering_facts.py index 179dadc253..b87efe93df 100644 --- a/lib/ansible/modules/cloud/amazon/ec2_vpc_peering_facts.py +++ b/lib/ansible/modules/cloud/amazon/ec2_vpc_peering_facts.py @@ -31,7 +31,9 @@ options: required: false default: None author: Karen Cheng(@Etherdaemon) -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/ec2_vpc_vgw.py b/lib/ansible/modules/cloud/amazon/ec2_vpc_vgw.py index 53c954acc4..a2d2793ffd 100644 --- a/lib/ansible/modules/cloud/amazon/ec2_vpc_vgw.py +++ b/lib/ansible/modules/cloud/amazon/ec2_vpc_vgw.py @@ -59,7 +59,6 @@ options: aliases: [ "resource_tags" ] author: Nick Aslanidis (@naslanidis) extends_documentation_fragment: - - aws - ec2 ''' diff --git a/lib/ansible/modules/cloud/amazon/ec2_vpc_vpn.py b/lib/ansible/modules/cloud/amazon/ec2_vpc_vpn.py index c7e4b52671..64df287aa2 100644 --- a/lib/ansible/modules/cloud/amazon/ec2_vpc_vpn.py +++ b/lib/ansible/modules/cloud/amazon/ec2_vpc_vpn.py @@ -15,6 +15,9 @@ description: - This module creates, modifies, and deletes VPN connections. Idempotence is achieved by using the filters option or specifying the VPN connection identifier. version_added: "2.4" +extends_documentation_fragment: + - ec2 + - aws requirements: ['boto3', 'botocore'] author: "Sloane Hertel (@s-hertel)" options: diff --git a/lib/ansible/modules/cloud/amazon/ecs_ecr.py b/lib/ansible/modules/cloud/amazon/ecs_ecr.py index 3c53034fa0..94d84c18cc 100644 --- a/lib/ansible/modules/cloud/amazon/ecs_ecr.py +++ b/lib/ansible/modules/cloud/amazon/ecs_ecr.py @@ -52,7 +52,9 @@ options: default: 'present' author: - David M. Lee (@leedm777) -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/efs_facts.py b/lib/ansible/modules/cloud/amazon/efs_facts.py index 3a20749acc..7dd4fe5713 100644 --- a/lib/ansible/modules/cloud/amazon/efs_facts.py +++ b/lib/ansible/modules/cloud/amazon/efs_facts.py @@ -45,7 +45,8 @@ options: required: false default: None extends_documentation_fragment: - - aws + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/elasticache_facts.py b/lib/ansible/modules/cloud/amazon/elasticache_facts.py index 3cd525d44d..45d5e5fa39 100644 --- a/lib/ansible/modules/cloud/amazon/elasticache_facts.py +++ b/lib/ansible/modules/cloud/amazon/elasticache_facts.py @@ -19,7 +19,9 @@ options: author: - Will Thames (@willthames) -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/elasticache_parameter_group.py b/lib/ansible/modules/cloud/amazon/elasticache_parameter_group.py index 9b286ca405..5d65db0deb 100644 --- a/lib/ansible/modules/cloud/amazon/elasticache_parameter_group.py +++ b/lib/ansible/modules/cloud/amazon/elasticache_parameter_group.py @@ -28,6 +28,9 @@ description: - Returns information about the specified cache cluster. version_added: "2.3" author: "Sloane Hertel (@s-hertel)" +extends_documentation_fragment: + - aws + - ec2 requirements: [ boto3, botocore ] options: group_family: diff --git a/lib/ansible/modules/cloud/amazon/elasticache_snapshot.py b/lib/ansible/modules/cloud/amazon/elasticache_snapshot.py index 7b9760b669..30aa884bed 100644 --- a/lib/ansible/modules/cloud/amazon/elasticache_snapshot.py +++ b/lib/ansible/modules/cloud/amazon/elasticache_snapshot.py @@ -20,6 +20,9 @@ description: - Returns information about the specified snapshot. version_added: "2.3" author: "Sloane Hertel (@s-hertel)" +extends_documentation_fragment: + - aws + - ec2 requirements: [ boto3, botocore ] options: name: diff --git a/lib/ansible/modules/cloud/amazon/execute_lambda.py b/lib/ansible/modules/cloud/amazon/execute_lambda.py index e0c9be5ac1..880f476a67 100644 --- a/lib/ansible/modules/cloud/amazon/execute_lambda.py +++ b/lib/ansible/modules/cloud/amazon/execute_lambda.py @@ -29,6 +29,7 @@ description: version_added: "2.2" extends_documentation_fragment: - aws + - ec2 author: "Ryan Scott Brown (@ryansb) " requirements: - python >= 2.6 diff --git a/lib/ansible/modules/cloud/amazon/iam.py b/lib/ansible/modules/cloud/amazon/iam.py index d2fc1ac8c8..8d48141486 100644 --- a/lib/ansible/modules/cloud/amazon/iam.py +++ b/lib/ansible/modules/cloud/amazon/iam.py @@ -99,7 +99,9 @@ notes: author: - "Jonathan I. Davila (@defionscode)" - "Paul Seiffert (@seiffert)" -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/iam_group.py b/lib/ansible/modules/cloud/amazon/iam_group.py index 2f4292c2ea..c1307c492c 100644 --- a/lib/ansible/modules/cloud/amazon/iam_group.py +++ b/lib/ansible/modules/cloud/amazon/iam_group.py @@ -57,6 +57,7 @@ options: requirements: [ botocore, boto3 ] extends_documentation_fragment: - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/iam_managed_policy.py b/lib/ansible/modules/cloud/amazon/iam_managed_policy.py index 66c4700189..d8e8cffbc7 100644 --- a/lib/ansible/modules/cloud/amazon/iam_managed_policy.py +++ b/lib/ansible/modules/cloud/amazon/iam_managed_policy.py @@ -45,6 +45,9 @@ options: default: null choices: [ "present", "absent" ] author: "Dan Kozlowski (@dkhenry)" +extends_documentation_fragment: + - aws + - ec2 requirements: - boto3 - botocore diff --git a/lib/ansible/modules/cloud/amazon/iam_role.py b/lib/ansible/modules/cloud/amazon/iam_role.py index 3659dcf49c..9f9d49aa8a 100644 --- a/lib/ansible/modules/cloud/amazon/iam_role.py +++ b/lib/ansible/modules/cloud/amazon/iam_role.py @@ -66,6 +66,7 @@ options: requirements: [ botocore, boto3 ] extends_documentation_fragment: - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/iam_role_facts.py b/lib/ansible/modules/cloud/amazon/iam_role_facts.py index a4c3ef37e8..8eb673d55f 100644 --- a/lib/ansible/modules/cloud/amazon/iam_role_facts.py +++ b/lib/ansible/modules/cloud/amazon/iam_role_facts.py @@ -37,7 +37,8 @@ options: required: false default: None extends_documentation_fragment: - - aws + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/lambda_alias.py b/lib/ansible/modules/cloud/amazon/lambda_alias.py index 01b160b40c..a12981d782 100644 --- a/lib/ansible/modules/cloud/amazon/lambda_alias.py +++ b/lib/ansible/modules/cloud/amazon/lambda_alias.py @@ -52,8 +52,8 @@ options: requirements: - boto3 extends_documentation_fragment: - - aws - + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/lambda_event.py b/lib/ansible/modules/cloud/amazon/lambda_event.py index 6484c0993a..c5d58698a8 100644 --- a/lib/ansible/modules/cloud/amazon/lambda_event.py +++ b/lib/ansible/modules/cloud/amazon/lambda_event.py @@ -66,7 +66,7 @@ requirements: - boto3 extends_documentation_fragment: - aws - + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/lambda_facts.py b/lib/ansible/modules/cloud/amazon/lambda_facts.py index 21ccf29fc5..71137e099e 100644 --- a/lib/ansible/modules/cloud/amazon/lambda_facts.py +++ b/lib/ansible/modules/cloud/amazon/lambda_facts.py @@ -52,8 +52,8 @@ author: Pierre Jodouin (@pjodouin) requirements: - boto3 extends_documentation_fragment: - - aws - + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/lambda_policy.py b/lib/ansible/modules/cloud/amazon/lambda_policy.py index c9b6057aee..5b6045ef99 100644 --- a/lib/ansible/modules/cloud/amazon/lambda_policy.py +++ b/lib/ansible/modules/cloud/amazon/lambda_policy.py @@ -91,8 +91,8 @@ options: requirements: - boto3 extends_documentation_fragment: - - aws - + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/lightsail.py b/lib/ansible/modules/cloud/amazon/lightsail.py index 0acc0daace..03a647f905 100644 --- a/lib/ansible/modules/cloud/amazon/lightsail.py +++ b/lib/ansible/modules/cloud/amazon/lightsail.py @@ -69,7 +69,9 @@ requirements: - "python >= 2.6" - boto3 -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 ''' diff --git a/lib/ansible/modules/cloud/amazon/rds_param_group.py b/lib/ansible/modules/cloud/amazon/rds_param_group.py index e8584b435b..7ddcd757c9 100644 --- a/lib/ansible/modules/cloud/amazon/rds_param_group.py +++ b/lib/ansible/modules/cloud/amazon/rds_param_group.py @@ -82,6 +82,7 @@ options: description: - Map of parameter names and values. Numeric values may be represented as K for kilo (1024), M for mega (1024^2), G for giga (1024^3), or T for tera (1024^4), and these values will be expanded into the appropriate number before being set in the parameter group. + aliases: [parameters] tags: description: - Dictionary of tags to attach to the parameter group diff --git a/lib/ansible/modules/cloud/amazon/redshift.py b/lib/ansible/modules/cloud/amazon/redshift.py index b01170388c..9a3a27dd7e 100644 --- a/lib/ansible/modules/cloud/amazon/redshift.py +++ b/lib/ansible/modules/cloud/amazon/redshift.py @@ -144,7 +144,9 @@ options: - how long before wait gives up, in seconds default: 300 requirements: [ 'boto' ] -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/redshift_subnet_group.py b/lib/ansible/modules/cloud/amazon/redshift_subnet_group.py index 0d8e40e7a5..74c8769757 100644 --- a/lib/ansible/modules/cloud/amazon/redshift_subnet_group.py +++ b/lib/ansible/modules/cloud/amazon/redshift_subnet_group.py @@ -45,7 +45,9 @@ options: default: null aliases: ['subnets'] requirements: [ 'boto' ] -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/route53_facts.py b/lib/ansible/modules/cloud/amazon/route53_facts.py index fe846c1cca..f0e491b90a 100644 --- a/lib/ansible/modules/cloud/amazon/route53_facts.py +++ b/lib/ansible/modules/cloud/amazon/route53_facts.py @@ -111,7 +111,9 @@ options: ] default: 'list' author: Karen Cheng(@Etherdaemon) -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/amazon/sns.py b/lib/ansible/modules/cloud/amazon/sns.py index 7fd60f489f..4ca9277422 100644 --- a/lib/ansible/modules/cloud/amazon/sns.py +++ b/lib/ansible/modules/cloud/amazon/sns.py @@ -84,7 +84,9 @@ options: required: true default: json choices: ['json', 'string'] - +extends_documentation_fragment: + - ec2 + - aws requirements: - "boto" """ diff --git a/lib/ansible/modules/cloud/amazon/sns_topic.py b/lib/ansible/modules/cloud/amazon/sns_topic.py index fe7c1115ee..474ac3d938 100644 --- a/lib/ansible/modules/cloud/amazon/sns_topic.py +++ b/lib/ansible/modules/cloud/amazon/sns_topic.py @@ -63,7 +63,9 @@ options: Blame Amazon." required: False default: True -extends_documentation_fragment: aws +extends_documentation_fragment: + - aws + - ec2 requirements: [ "boto" ] """ diff --git a/lib/ansible/modules/cloud/cloudstack/cs_network_offering.py b/lib/ansible/modules/cloud/cloudstack/cs_network_offering.py index 59a0ed90f7..4f2c1b5c7b 100644 --- a/lib/ansible/modules/cloud/cloudstack/cs_network_offering.py +++ b/lib/ansible/modules/cloud/cloudstack/cs_network_offering.py @@ -83,10 +83,11 @@ options: service_offering: description: - The service offering name or ID used by virtual router provider. - service_provider_list: + service_provider: description: - Provider to service mapping. - If not specified, the provider for the service will be mapped to the default provider on the physical network. + aliases: [service_provider] specify_ip_ranges: description: - Wheter the network offering supports specifying IP ranges. diff --git a/lib/ansible/modules/cloud/digital_ocean/digital_ocean.py b/lib/ansible/modules/cloud/digital_ocean/digital_ocean.py index f3049eb848..6936aaaeff 100644 --- a/lib/ansible/modules/cloud/digital_ocean/digital_ocean.py +++ b/lib/ansible/modules/cloud/digital_ocean/digital_ocean.py @@ -39,6 +39,7 @@ options: id: description: - Numeric, the droplet id you want to operate on. + aliases: ['droplet_id'] name: description: - String, this is the name of the droplet - must be formatted by hostname rules, or the name of a SSH key. diff --git a/lib/ansible/modules/cloud/digital_ocean/digital_ocean_certificate.py b/lib/ansible/modules/cloud/digital_ocean/digital_ocean_certificate.py index ce17e3bf61..258d37fc11 100644 --- a/lib/ansible/modules/cloud/digital_ocean/digital_ocean_certificate.py +++ b/lib/ansible/modules/cloud/digital_ocean/digital_ocean_certificate.py @@ -43,6 +43,7 @@ options: description: - DigitalOcean OAuth token. required: true + aliases: ['DO_API_TOKEN', 'DO_API_KEY', 'DO_OAUTH_TOKEN'] notes: - Two environment variables can be used, DO_API_KEY, DO_OAUTH_TOKEN and DO_API_TOKEN. diff --git a/lib/ansible/modules/cloud/digital_ocean/digital_ocean_domain.py b/lib/ansible/modules/cloud/digital_ocean/digital_ocean_domain.py index 5568915c67..3e0f9017f1 100644 --- a/lib/ansible/modules/cloud/digital_ocean/digital_ocean_domain.py +++ b/lib/ansible/modules/cloud/digital_ocean/digital_ocean_domain.py @@ -31,10 +31,11 @@ options: description: - DigitalOcean api token. version_added: "1.9.5" - aliases: ['api_token'] + aliases: ['API_TOKEN'] id: description: - Numeric, the droplet id you want to operate on. + aliases: ['droplet_id'] name: description: - String, this is the name of the droplet - must be formatted by hostname rules, or the name of a SSH key, or the name of a domain. diff --git a/lib/ansible/modules/cloud/digital_ocean/digital_ocean_sshkey.py b/lib/ansible/modules/cloud/digital_ocean/digital_ocean_sshkey.py index 2fe1452f05..59a6c3ccda 100644 --- a/lib/ansible/modules/cloud/digital_ocean/digital_ocean_sshkey.py +++ b/lib/ansible/modules/cloud/digital_ocean/digital_ocean_sshkey.py @@ -33,6 +33,7 @@ options: required: false default: None version_added: 2.4 + aliases: ['id'] name: description: - The name for the SSH key diff --git a/lib/ansible/modules/cloud/digital_ocean/digital_ocean_tag.py b/lib/ansible/modules/cloud/digital_ocean/digital_ocean_tag.py index 5d314f35c4..30a318520c 100644 --- a/lib/ansible/modules/cloud/digital_ocean/digital_ocean_tag.py +++ b/lib/ansible/modules/cloud/digital_ocean/digital_ocean_tag.py @@ -31,6 +31,7 @@ options: description: - The ID of the resource to operate on. - The data type of resource_id is changed from integer to string, from version 2.5. + aliases: ['droplet_id'] resource_type: description: - The type of resource to operate on. Currently, only tagging of diff --git a/lib/ansible/modules/cloud/packet/packet_device.py b/lib/ansible/modules/cloud/packet/packet_device.py index 0406f9ea88..6e1518b758 100644 --- a/lib/ansible/modules/cloud/packet/packet_device.py +++ b/lib/ansible/modules/cloud/packet/packet_device.py @@ -98,12 +98,6 @@ options: description: - Userdata blob made available to the machine - wait: - description: - - Whether to wait for the instance to be assigned IP address before returning. - - This option has been deprecated in favor of C(wait_for_public_IPv). - default: false - wait_for_public_IPv: description: - Whether to wait for the instance to be assigned a public IPv4/IPv6 address. diff --git a/lib/ansible/modules/cloud/rackspace/rax_cdb.py b/lib/ansible/modules/cloud/rackspace/rax_cdb.py index ced4369676..7261c2dcaa 100644 --- a/lib/ansible/modules/cloud/rackspace/rax_cdb.py +++ b/lib/ansible/modules/cloud/rackspace/rax_cdb.py @@ -60,7 +60,9 @@ options: - how long before wait gives up, in seconds default: 300 author: "Simon JAILLET (@jails)" -extends_documentation_fragment: rackspace +extends_documentation_fragment: + - rackspace + - rackspace.openstack ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/rackspace/rax_cdb_database.py b/lib/ansible/modules/cloud/rackspace/rax_cdb_database.py index 443e038971..5969e7448e 100644 --- a/lib/ansible/modules/cloud/rackspace/rax_cdb_database.py +++ b/lib/ansible/modules/cloud/rackspace/rax_cdb_database.py @@ -40,7 +40,9 @@ options: choices: ['present', 'absent'] default: present author: "Simon JAILLET (@jails)" -extends_documentation_fragment: rackspace +extends_documentation_fragment: + - rackspace + - rackspace.openstack ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/rackspace/rax_cdb_user.py b/lib/ansible/modules/cloud/rackspace/rax_cdb_user.py index 0180265fcf..eac23bd016 100644 --- a/lib/ansible/modules/cloud/rackspace/rax_cdb_user.py +++ b/lib/ansible/modules/cloud/rackspace/rax_cdb_user.py @@ -47,7 +47,9 @@ options: choices: ['present', 'absent'] default: present author: "Simon JAILLET (@jails)" -extends_documentation_fragment: rackspace +extends_documentation_fragment: + - rackspace + - rackspace.openstack ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/rackspace/rax_clb.py b/lib/ansible/modules/cloud/rackspace/rax_clb.py index f00bd5e63e..d539934f4e 100644 --- a/lib/ansible/modules/cloud/rackspace/rax_clb.py +++ b/lib/ansible/modules/cloud/rackspace/rax_clb.py @@ -101,7 +101,9 @@ options: author: - "Christopher H. Laco (@claco)" - "Matt Martz (@sivel)" -extends_documentation_fragment: rackspace +extends_documentation_fragment: + - rackspace + - rackspace.openstack ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/rackspace/rax_clb_nodes.py b/lib/ansible/modules/cloud/rackspace/rax_clb_nodes.py index 48bf02a664..68426656f7 100644 --- a/lib/ansible/modules/cloud/rackspace/rax_clb_nodes.py +++ b/lib/ansible/modules/cloud/rackspace/rax_clb_nodes.py @@ -77,7 +77,9 @@ options: description: - Weight of node author: "Lukasz Kawczynski (@neuroid)" -extends_documentation_fragment: rackspace +extends_documentation_fragment: + - rackspace + - rackspace.openstack ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/rackspace/rax_clb_ssl.py b/lib/ansible/modules/cloud/rackspace/rax_clb_ssl.py index 6dfee78817..92a5188a33 100644 --- a/lib/ansible/modules/cloud/rackspace/rax_clb_ssl.py +++ b/lib/ansible/modules/cloud/rackspace/rax_clb_ssl.py @@ -67,7 +67,9 @@ options: - How long before "wait" gives up, in seconds. default: 300 author: Ash Wilson -extends_documentation_fragment: rackspace +extends_documentation_fragment: + - rackspace + - rackspace.openstack ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/rackspace/rax_dns.py b/lib/ansible/modules/cloud/rackspace/rax_dns.py index 1a0aaba6f6..e3f7835800 100644 --- a/lib/ansible/modules/cloud/rackspace/rax_dns.py +++ b/lib/ansible/modules/cloud/rackspace/rax_dns.py @@ -44,7 +44,9 @@ notes: C(serial: 1) to avoid exceeding the API request limit imposed by the Rackspace CloudDNS API" author: "Matt Martz (@sivel)" -extends_documentation_fragment: rackspace +extends_documentation_fragment: + - rackspace + - rackspace.openstack ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/rackspace/rax_dns_record.py b/lib/ansible/modules/cloud/rackspace/rax_dns_record.py index 6ed9b4fdc8..8bf0d2c624 100644 --- a/lib/ansible/modules/cloud/rackspace/rax_dns_record.py +++ b/lib/ansible/modules/cloud/rackspace/rax_dns_record.py @@ -87,7 +87,9 @@ notes: - As of version 1.7, the C(type) field is required and no longer defaults to an C(A) record. - C(PTR) record support was added in version 1.7 author: "Matt Martz (@sivel)" -extends_documentation_fragment: rackspace +extends_documentation_fragment: + - rackspace + - rackspace.openstack ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/rackspace/rax_files.py b/lib/ansible/modules/cloud/rackspace/rax_files.py index 771bde39b8..68742d3f89 100644 --- a/lib/ansible/modules/cloud/rackspace/rax_files.py +++ b/lib/ansible/modules/cloud/rackspace/rax_files.py @@ -70,7 +70,9 @@ options: description: - Sets an object to be presented as the HTTP index page when accessed by the CDN URL author: "Paul Durivage (@angstwad)" -extends_documentation_fragment: rackspace +extends_documentation_fragment: + - rackspace + - rackspace.openstack ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/rackspace/rax_files_objects.py b/lib/ansible/modules/cloud/rackspace/rax_files_objects.py index 465157a63f..9138cacc66 100644 --- a/lib/ansible/modules/cloud/rackspace/rax_files_objects.py +++ b/lib/ansible/modules/cloud/rackspace/rax_files_objects.py @@ -86,7 +86,9 @@ options: - meta default: file author: "Paul Durivage (@angstwad)" -extends_documentation_fragment: rackspace +extends_documentation_fragment: + - rackspace + - rackspace.openstack ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/rackspace/rax_queue.py b/lib/ansible/modules/cloud/rackspace/rax_queue.py index 129c6d5c4f..a83dd36826 100644 --- a/lib/ansible/modules/cloud/rackspace/rax_queue.py +++ b/lib/ansible/modules/cloud/rackspace/rax_queue.py @@ -33,7 +33,9 @@ options: author: - "Christopher H. Laco (@claco)" - "Matt Martz (@sivel)" -extends_documentation_fragment: rackspace +extends_documentation_fragment: + - rackspace + - rackspace.openstack ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/rackspace/rax_scaling_group.py b/lib/ansible/modules/cloud/rackspace/rax_scaling_group.py index ff51218e6a..2ba30a11b6 100644 --- a/lib/ansible/modules/cloud/rackspace/rax_scaling_group.py +++ b/lib/ansible/modules/cloud/rackspace/rax_scaling_group.py @@ -113,7 +113,9 @@ options: - how long before wait gives up, in seconds default: 300 author: "Matt Martz (@sivel)" -extends_documentation_fragment: rackspace +extends_documentation_fragment: + - rackspace + - rackspace.openstack ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/rackspace/rax_scaling_policy.py b/lib/ansible/modules/cloud/rackspace/rax_scaling_policy.py index 6e56c762ab..0db7a5758b 100644 --- a/lib/ansible/modules/cloud/rackspace/rax_scaling_policy.py +++ b/lib/ansible/modules/cloud/rackspace/rax_scaling_policy.py @@ -69,7 +69,9 @@ options: - absent default: present author: "Matt Martz (@sivel)" -extends_documentation_fragment: rackspace +extends_documentation_fragment: + - rackspace + - rackspace.openstack ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/cloud/spotinst/spotinst_aws_elastigroup.py b/lib/ansible/modules/cloud/spotinst/spotinst_aws_elastigroup.py index 3a868248c4..ced3bde0fd 100644 --- a/lib/ansible/modules/cloud/spotinst/spotinst_aws_elastigroup.py +++ b/lib/ansible/modules/cloud/spotinst/spotinst_aws_elastigroup.py @@ -311,7 +311,7 @@ options: In case of update it will override the existing Security Group with the new given array required: true - shut_down_script: + shutdown_script: description: - (String) The Base64-encoded shutdown script that executes prior to instance termination. Encode before setting. diff --git a/lib/ansible/modules/clustering/openshift/_oc.py b/lib/ansible/modules/clustering/openshift/_oc.py index 45fa4c3bd3..c76ae8ac5b 100644 --- a/lib/ansible/modules/clustering/openshift/_oc.py +++ b/lib/ansible/modules/clustering/openshift/_oc.py @@ -40,6 +40,7 @@ options: description: - "The inline definition of the resource. This is mutually exclusive with name, namespace and kind." required: false + aliases: ['def', 'definition'] kind: description: The kind of the resource upon which to take action. required: true @@ -53,8 +54,15 @@ options: required: false token: description: - - "The token with which to authenticate agains the OpenShift cluster." + - "The token with which to authenticate against the OpenShift cluster." required: true + validate_certs: + description: + - If C(no), SSL certificates for the target url will not be validated. + This should only be used on personally controlled sites using + self-signed certificates. + type: bool + default: yes state: choices: - present diff --git a/lib/ansible/modules/crypto/openssl_certificate.py b/lib/ansible/modules/crypto/openssl_certificate.py index 9f64763adc..7a21623c9e 100644 --- a/lib/ansible/modules/crypto/openssl_certificate.py +++ b/lib/ansible/modules/crypto/openssl_certificate.py @@ -94,7 +94,7 @@ options: If this value is not specified, certificate will stop being valid 10 years from now. aliases: [ selfsigned_notAfter ] - acme_accountkey: + acme_accountkey_path: description: - Path to the accountkey for the C(acme) provider @@ -219,7 +219,7 @@ EXAMPLES = ''' path: /etc/ssl/crt/ansible.com.crt csr_path: /etc/ssl/csr/ansible.com.csr provider: acme - acme_accountkey: /etc/ssl/private/ansible.com.pem + acme_accountkey_path: /etc/ssl/private/ansible.com.pem acme_challenge_path: /etc/ssl/challenges/ansible.com/ - name: Force (re-)generate a new Let's Encrypt Certificate @@ -227,7 +227,7 @@ EXAMPLES = ''' path: /etc/ssl/crt/ansible.com.crt csr_path: /etc/ssl/csr/ansible.com.csr provider: acme - acme_accountkey: /etc/ssl/private/ansible.com.pem + acme_accountkey_path: /etc/ssl/private/ansible.com.pem acme_challenge_path: /etc/ssl/challenges/ansible.com/ force: True diff --git a/lib/ansible/modules/database/postgresql/postgresql_privs.py b/lib/ansible/modules/database/postgresql/postgresql_privs.py index e889cb315b..098882c04d 100644 --- a/lib/ansible/modules/database/postgresql/postgresql_privs.py +++ b/lib/ansible/modules/database/postgresql/postgresql_privs.py @@ -150,6 +150,8 @@ notes: - When revoking privileges, C(RESTRICT) is assumed (see PostgreSQL docs). - The ssl_rootcert parameter requires at least Postgres version 8.4 and I(psycopg2) version 2.4.3. requirements: [psycopg2] +extends_documentation_fragment: + - postgres author: "Bernhard Weitzhofer (@b6d)" """ diff --git a/lib/ansible/modules/database/vertica/vertica_configuration.py b/lib/ansible/modules/database/vertica/vertica_configuration.py index b4734edf52..485d1beef8 100644 --- a/lib/ansible/modules/database/vertica/vertica_configuration.py +++ b/lib/ansible/modules/database/vertica/vertica_configuration.py @@ -24,6 +24,7 @@ options: description: - Name of the parameter to update. required: true + aliases: [parameter] value: description: - Value of the parameter to be set. diff --git a/lib/ansible/modules/network/a10/a10_server.py b/lib/ansible/modules/network/a10/a10_server.py index f7891cf8a2..a1bb77ddb8 100644 --- a/lib/ansible/modules/network/a10/a10_server.py +++ b/lib/ansible/modules/network/a10/a10_server.py @@ -25,7 +25,9 @@ description: author: "Eric Chou (@ericchou) 2016, Mischa Peters (@mischapeters) 2014" notes: - Requires A10 Networks aXAPI 2.1. -extends_documentation_fragment: a10 +extends_documentation_fragment: + - a10 + - url options: partition: version_added: "2.3" @@ -59,6 +61,7 @@ options: required when C(state) is C(present). required: false default: null + aliases: ['port'] state: description: - This is to specify the operation to create, update or remove SLB server. diff --git a/lib/ansible/modules/network/a10/a10_server_axapi3.py b/lib/ansible/modules/network/a10/a10_server_axapi3.py index 64b5a3540d..8e8951dc30 100644 --- a/lib/ansible/modules/network/a10/a10_server_axapi3.py +++ b/lib/ansible/modules/network/a10/a10_server_axapi3.py @@ -23,7 +23,9 @@ short_description: Manage A10 Networks AX/SoftAX/Thunder/vThunder devices description: - Manage SLB (Server Load Balancer) server objects on A10 Networks devices via aXAPIv3. author: "Eric Chou (@ericchou) based on previous work by Mischa Peters (@mischapeters)" -extends_documentation_fragment: a10 +extends_documentation_fragment: + - a10 + - url options: server_name: description: @@ -48,6 +50,7 @@ options: and C(protocol:). required: false default: null + aliases: ['port'] operation: description: - Create, Update or Remove SLB server. For create and update operation, we use the IP address and server diff --git a/lib/ansible/modules/network/a10/a10_service_group.py b/lib/ansible/modules/network/a10/a10_service_group.py index a63cd28a33..dc3dcb3645 100644 --- a/lib/ansible/modules/network/a10/a10_service_group.py +++ b/lib/ansible/modules/network/a10/a10_service_group.py @@ -26,8 +26,15 @@ author: "Eric Chou (@ericchou) 2016, Mischa Peters (@mischapeters) 2014" notes: - Requires A10 Networks aXAPI 2.1. - When a server doesn't exist and is added to the service-group the server will be created. -extends_documentation_fragment: a10 +extends_documentation_fragment: + - a10 + - url options: + state: + description: + - If the specified service group should exists. + default: present + choices: ['present', 'absent'] partition: version_added: "2.3" description: @@ -72,6 +79,7 @@ options: specify the C(status:). See the examples below for details. required: false default: null + aliases: ['server', 'member'] validate_certs: description: - If C(no), SSL certificates will not be validated. This should only be used diff --git a/lib/ansible/modules/network/a10/a10_virtual_server.py b/lib/ansible/modules/network/a10/a10_virtual_server.py index c007a9128a..1c3afea626 100644 --- a/lib/ansible/modules/network/a10/a10_virtual_server.py +++ b/lib/ansible/modules/network/a10/a10_virtual_server.py @@ -25,8 +25,15 @@ description: author: "Eric Chou (@ericchou) 2016, Mischa Peters (@mischapeters) 2014" notes: - Requires A10 Networks aXAPI 2.1. -extends_documentation_fragment: a10 +extends_documentation_fragment: + - a10 + - url options: + state: + description: + - If the specified virtual server should exist. + choices: ['present', 'absent'] + default: present partition: version_added: "2.3" description: diff --git a/lib/ansible/modules/network/asa/asa_acl.py b/lib/ansible/modules/network/asa/asa_acl.py index 0f5c51d5c5..0a7c1fa6f7 100644 --- a/lib/ansible/modules/network/asa/asa_acl.py +++ b/lib/ansible/modules/network/asa/asa_acl.py @@ -30,6 +30,7 @@ options: command syntax as some commands are automatically modified by the device config parser. required: true + aliases: [commands] before: description: - The ordered set of commands to push on to the command stack if diff --git a/lib/ansible/modules/network/cloudengine/ce_aaa_server_host.py b/lib/ansible/modules/network/cloudengine/ce_aaa_server_host.py index 2cba7cb4df..db18711f39 100644 --- a/lib/ansible/modules/network/cloudengine/ce_aaa_server_host.py +++ b/lib/ansible/modules/network/cloudengine/ce_aaa_server_host.py @@ -201,7 +201,7 @@ EXAMPLES = ''' ce_aaa_server_host: state: present radius_group_name: group1 - raduis_server_type: Authentication + radius_server_type: Authentication radius_server_ip: 10.1.10.1 radius_server_port: 2000 radius_server_mode: Primary-server @@ -212,7 +212,7 @@ EXAMPLES = ''' ce_aaa_server_host: state: absent radius_group_name: group1 - raduis_server_type: Authentication + radius_server_type: Authentication radius_server_ip: 10.1.10.1 radius_server_port: 2000 radius_server_mode: Primary-server @@ -1059,7 +1059,7 @@ class AaaServerHost(object): module = kwargs["module"] radius_group_name = module.params['radius_group_name'] - raduis_server_type = module.params['raduis_server_type'] + radius_server_type = module.params['radius_server_type'] radius_server_ip = module.params['radius_server_ip'] radius_server_port = module.params['radius_server_port'] radius_server_mode = module.params['radius_server_mode'] @@ -1099,10 +1099,10 @@ class AaaServerHost(object): for tmp in result["radius_server_ip_v4"]: if "serverType" in tmp.keys(): if state == "present": - if tmp["serverType"] != raduis_server_type: + if tmp["serverType"] != radius_server_type: need_cfg = True else: - if tmp["serverType"] == raduis_server_type: + if tmp["serverType"] == radius_server_type: need_cfg = True if "serverIPAddress" in tmp.keys(): if state == "present": @@ -1141,14 +1141,14 @@ class AaaServerHost(object): module = kwargs["module"] radius_group_name = module.params['radius_group_name'] - raduis_server_type = module.params['raduis_server_type'] + radius_server_type = module.params['radius_server_type'] radius_server_ip = module.params['radius_server_ip'] radius_server_port = module.params['radius_server_port'] radius_server_mode = module.params['radius_server_mode'] radius_vpn_name = module.params['radius_vpn_name'] conf_str = CE_MERGE_RADIUS_SERVER_CFG_IPV4 % ( - radius_group_name, raduis_server_type, + radius_group_name, radius_server_type, radius_server_ip, radius_server_port, radius_server_mode, radius_vpn_name) @@ -1163,7 +1163,7 @@ class AaaServerHost(object): cmd = "radius server group %s" % radius_group_name cmds.append(cmd) - if raduis_server_type == "Authentication": + if radius_server_type == "Authentication": cmd = "radius server authentication %s %s" % ( radius_server_ip, radius_server_port) @@ -1190,14 +1190,14 @@ class AaaServerHost(object): module = kwargs["module"] radius_group_name = module.params['radius_group_name'] - raduis_server_type = module.params['raduis_server_type'] + radius_server_type = module.params['radius_server_type'] radius_server_ip = module.params['radius_server_ip'] radius_server_port = module.params['radius_server_port'] radius_server_mode = module.params['radius_server_mode'] radius_vpn_name = module.params['radius_vpn_name'] conf_str = CE_DELETE_RADIUS_SERVER_CFG_IPV4 % ( - radius_group_name, raduis_server_type, + radius_group_name, radius_server_type, radius_server_ip, radius_server_port, radius_server_mode, radius_vpn_name) @@ -1212,7 +1212,7 @@ class AaaServerHost(object): cmd = "radius server group %s" % radius_group_name cmds.append(cmd) - if raduis_server_type == "Authentication": + if radius_server_type == "Authentication": cmd = "undo radius server authentication %s %s" % ( radius_server_ip, radius_server_port) @@ -1239,7 +1239,7 @@ class AaaServerHost(object): module = kwargs["module"] radius_group_name = module.params['radius_group_name'] - raduis_server_type = module.params['raduis_server_type'] + radius_server_type = module.params['radius_server_type'] radius_server_ipv6 = module.params['radius_server_ipv6'] radius_server_port = module.params['radius_server_port'] radius_server_mode = module.params['radius_server_mode'] @@ -1278,10 +1278,10 @@ class AaaServerHost(object): for tmp in result["radius_server_ip_v6"]: if "serverType" in tmp.keys(): if state == "present": - if tmp["serverType"] != raduis_server_type: + if tmp["serverType"] != radius_server_type: need_cfg = True else: - if tmp["serverType"] == raduis_server_type: + if tmp["serverType"] == radius_server_type: need_cfg = True if "serverIPAddress" in tmp.keys(): if state == "present": @@ -1313,13 +1313,13 @@ class AaaServerHost(object): module = kwargs["module"] radius_group_name = module.params['radius_group_name'] - raduis_server_type = module.params['raduis_server_type'] + radius_server_type = module.params['radius_server_type'] radius_server_ipv6 = module.params['radius_server_ipv6'] radius_server_port = module.params['radius_server_port'] radius_server_mode = module.params['radius_server_mode'] conf_str = CE_MERGE_RADIUS_SERVER_CFG_IPV6 % ( - radius_group_name, raduis_server_type, + radius_group_name, radius_server_type, radius_server_ipv6, radius_server_port, radius_server_mode) @@ -1334,7 +1334,7 @@ class AaaServerHost(object): cmd = "radius server group %s" % radius_group_name cmds.append(cmd) - if raduis_server_type == "Authentication": + if radius_server_type == "Authentication": cmd = "radius server authentication %s %s" % ( radius_server_ipv6, radius_server_port) @@ -1355,13 +1355,13 @@ class AaaServerHost(object): module = kwargs["module"] radius_group_name = module.params['radius_group_name'] - raduis_server_type = module.params['raduis_server_type'] + radius_server_type = module.params['radius_server_type'] radius_server_ipv6 = module.params['radius_server_ipv6'] radius_server_port = module.params['radius_server_port'] radius_server_mode = module.params['radius_server_mode'] conf_str = CE_DELETE_RADIUS_SERVER_CFG_IPV6 % ( - radius_group_name, raduis_server_type, + radius_group_name, radius_server_type, radius_server_ipv6, radius_server_port, radius_server_mode) @@ -1376,7 +1376,7 @@ class AaaServerHost(object): cmd = "radius server group %s" % radius_group_name cmds.append(cmd) - if raduis_server_type == "Authentication": + if radius_server_type == "Authentication": cmd = "undo radius server authentication %s %s" % ( radius_server_ipv6, radius_server_port) @@ -1397,7 +1397,7 @@ class AaaServerHost(object): module = kwargs["module"] radius_group_name = module.params['radius_group_name'] - raduis_server_type = module.params['raduis_server_type'] + radius_server_type = module.params['radius_server_type'] radius_server_name = module.params['radius_server_name'] radius_server_port = module.params['radius_server_port'] radius_server_mode = module.params['radius_server_mode'] @@ -1437,10 +1437,10 @@ class AaaServerHost(object): for tmp in result["radius_server_name_cfg"]: if "serverType" in tmp.keys(): if state == "present": - if tmp["serverType"] != raduis_server_type: + if tmp["serverType"] != radius_server_type: need_cfg = True else: - if tmp["serverType"] == raduis_server_type: + if tmp["serverType"] == radius_server_type: need_cfg = True if "serverName" in tmp.keys(): if state == "present": @@ -1479,14 +1479,14 @@ class AaaServerHost(object): module = kwargs["module"] radius_group_name = module.params['radius_group_name'] - raduis_server_type = module.params['raduis_server_type'] + radius_server_type = module.params['radius_server_type'] radius_server_name = module.params['radius_server_name'] radius_server_port = module.params['radius_server_port'] radius_server_mode = module.params['radius_server_mode'] radius_vpn_name = module.params['radius_vpn_name'] conf_str = CE_MERGE_RADIUS_SERVER_NAME % ( - radius_group_name, raduis_server_type, + radius_group_name, radius_server_type, radius_server_name, radius_server_port, radius_server_mode, radius_vpn_name) @@ -1500,7 +1500,7 @@ class AaaServerHost(object): cmd = "radius server group %s" % radius_group_name cmds.append(cmd) - if raduis_server_type == "Authentication": + if radius_server_type == "Authentication": cmd = "radius server authentication hostname %s %s" % ( radius_server_name, radius_server_port) @@ -1527,14 +1527,14 @@ class AaaServerHost(object): module = kwargs["module"] radius_group_name = module.params['radius_group_name'] - raduis_server_type = module.params['raduis_server_type'] + radius_server_type = module.params['radius_server_type'] radius_server_name = module.params['radius_server_name'] radius_server_port = module.params['radius_server_port'] radius_server_mode = module.params['radius_server_mode'] radius_vpn_name = module.params['radius_vpn_name'] conf_str = CE_DELETE_RADIUS_SERVER_NAME % ( - radius_group_name, raduis_server_type, + radius_group_name, radius_server_type, radius_server_name, radius_server_port, radius_server_mode, radius_vpn_name) @@ -1548,7 +1548,7 @@ class AaaServerHost(object): cmd = "radius server group %s" % radius_group_name cmds.append(cmd) - if raduis_server_type == "Authentication": + if radius_server_type == "Authentication": cmd = "undo radius server authentication hostname %s %s" % ( radius_server_name, radius_server_port) @@ -2319,7 +2319,7 @@ def main(): local_user_level=dict(type='str'), local_user_group=dict(type='str'), radius_group_name=dict(type='str'), - raduis_server_type=dict(choices=['Authentication', 'Accounting']), + radius_server_type=dict(choices=['Authentication', 'Accounting']), radius_server_ip=dict(type='str'), radius_server_ipv6=dict(type='str'), radius_server_port=dict(type='str'), @@ -2366,7 +2366,7 @@ def main(): # radius para radius_group_name = module.params['radius_group_name'] - raduis_server_type = module.params['raduis_server_type'] + radius_server_type = module.params['radius_server_type'] radius_server_ip = module.params['radius_server_ip'] radius_server_ipv6 = module.params['radius_server_ipv6'] radius_server_port = module.params['radius_server_port'] @@ -2406,8 +2406,8 @@ def main(): proposed["local_user_group"] = local_user_group if radius_group_name: proposed["radius_group_name"] = radius_group_name - if raduis_server_type: - proposed["raduis_server_type"] = raduis_server_type + if radius_server_type: + proposed["radius_server_type"] = radius_server_type if radius_server_ip: proposed["radius_server_ip"] = radius_server_ip if radius_server_ipv6: @@ -2480,9 +2480,9 @@ def main(): module.fail_json( msg='Error: Please do not input radius_server_ip and radius_server_ipv6 at the same time.') - if not raduis_server_type or not radius_server_port or not radius_server_mode or not radius_vpn_name: + if not radius_server_type or not radius_server_port or not radius_server_mode or not radius_vpn_name: module.fail_json( - msg='Error: Please input raduis_server_type radius_server_port radius_server_mode radius_vpn_name.') + msg='Error: Please input radius_server_type radius_server_port radius_server_mode radius_vpn_name.') if radius_server_ip: rds_server_ipv4_result = ce_aaa_server_host.get_radius_server_cfg_ipv4( diff --git a/lib/ansible/modules/network/dellos10/dellos10_command.py b/lib/ansible/modules/network/dellos10/dellos10_command.py index 0364b8f52e..5a2a11e519 100644 --- a/lib/ansible/modules/network/dellos10/dellos10_command.py +++ b/lib/ansible/modules/network/dellos10/dellos10_command.py @@ -173,7 +173,7 @@ def main(): # { command: , prompt: , response: } commands=dict(type='list', required=True), - wait_for=dict(type='list', aliases=['waitfor']), + wait_for=dict(type='list'), match=dict(default='all', choices=['all', 'any']), retries=dict(default=10, type='int'), diff --git a/lib/ansible/modules/network/dellos6/dellos6_command.py b/lib/ansible/modules/network/dellos6/dellos6_command.py index ff01e75690..2159a33b10 100644 --- a/lib/ansible/modules/network/dellos6/dellos6_command.py +++ b/lib/ansible/modules/network/dellos6/dellos6_command.py @@ -174,7 +174,7 @@ def main(): # { command: , prompt: , response: } commands=dict(type='list', required=True), - wait_for=dict(type='list', aliases=['waitfor']), + wait_for=dict(type='list'), match=dict(default='all', choices=['all', 'any']), retries=dict(default=10, type='int'), diff --git a/lib/ansible/modules/network/dellos9/dellos9_command.py b/lib/ansible/modules/network/dellos9/dellos9_command.py index 380dc175c5..1d1f6bbeb8 100644 --- a/lib/ansible/modules/network/dellos9/dellos9_command.py +++ b/lib/ansible/modules/network/dellos9/dellos9_command.py @@ -178,7 +178,7 @@ def main(): # { command: , prompt: , response: } commands=dict(type='list', required=True), - wait_for=dict(type='list', aliases=['waitfor']), + wait_for=dict(type='list'), match=dict(default='all', choices=['all', 'any']), retries=dict(default=10, type='int'), diff --git a/lib/ansible/modules/network/eos/eos_config.py b/lib/ansible/modules/network/eos/eos_config.py index 45cfcfcf16..574c89d313 100644 --- a/lib/ansible/modules/network/eos/eos_config.py +++ b/lib/ansible/modules/network/eos/eos_config.py @@ -45,6 +45,7 @@ options: command syntax as some commands are automatically modified by the device config parser. required: false + aliases: ['commands'] default: null parents: description: diff --git a/lib/ansible/modules/network/eos/eos_system.py b/lib/ansible/modules/network/eos/eos_system.py index 3ab319f5e7..05b24fbd05 100644 --- a/lib/ansible/modules/network/eos/eos_system.py +++ b/lib/ansible/modules/network/eos/eos_system.py @@ -52,6 +52,7 @@ options: append to the hostname for the purpose of doing name resolution. This argument accepts a list of names and will be reconciled with the current active configuration on the running node. + aliases: ['domain_list'] lookup_source: description: - Provides one or more source diff --git a/lib/ansible/modules/network/eos/eos_user.py b/lib/ansible/modules/network/eos/eos_user.py index 2b8d0bf9a7..627c14c96c 100644 --- a/lib/ansible/modules/network/eos/eos_user.py +++ b/lib/ansible/modules/network/eos/eos_user.py @@ -42,7 +42,8 @@ options: - The set of username objects to be configured on the remote Arista EOS device. The list entries can either be the username or a hash of username and properties. This argument is mutually - exclusive with the C(username) argument. alias C(users). + exclusive with the C(username) argument. + aliases: ['users', 'collection'] version_added: "2.4" name: description: diff --git a/lib/ansible/modules/network/illumos/dladm_iptun.py b/lib/ansible/modules/network/illumos/dladm_iptun.py index 74b0e197bf..9f5ac5fe94 100644 --- a/lib/ansible/modules/network/illumos/dladm_iptun.py +++ b/lib/ansible/modules/network/illumos/dladm_iptun.py @@ -26,7 +26,6 @@ options: description: - IP tunnel interface name. required: true - aliases: [ "tunnel", "link" ] temporary: description: - Specifies that the IP tunnel interface is temporary. Temporary IP tunnel @@ -39,6 +38,7 @@ options: required: false default: "ipv4" choices: [ "ipv4", "ipv6", "6to4" ] + aliases: ['tunnel_type'] local_address: description: - Literat IP address or hostname corresponding to the tunnel source. diff --git a/lib/ansible/modules/network/illumos/flowadm.py b/lib/ansible/modules/network/illumos/flowadm.py index 274436c893..bc37102a1f 100644 --- a/lib/ansible/modules/network/illumos/flowadm.py +++ b/lib/ansible/modules/network/illumos/flowadm.py @@ -36,7 +36,7 @@ options: description: - Identifies a network flow by the local IP address. required: false - remove_ip: + remote_ip: description: - Identifies a network flow by the remote IP address. required: false diff --git a/lib/ansible/modules/network/illumos/ipadm_addrprop.py b/lib/ansible/modules/network/illumos/ipadm_addrprop.py index 93ed8faf21..3e008a303f 100644 --- a/lib/ansible/modules/network/illumos/ipadm_addrprop.py +++ b/lib/ansible/modules/network/illumos/ipadm_addrprop.py @@ -191,7 +191,7 @@ class AddrProp(object): def main(): module = AnsibleModule( argument_spec=dict( - addrobj=dict(required=True, default=None, aliases=['nic, interface']), + addrobj=dict(required=True, default=None, aliases=['nic', 'interface']), property=dict(required=True, aliases=['name']), value=dict(required=False), temporary=dict(default=False, type='bool'), diff --git a/lib/ansible/modules/network/ios/ios_user.py b/lib/ansible/modules/network/ios/ios_user.py index 673eea848a..243df781d7 100644 --- a/lib/ansible/modules/network/ios/ios_user.py +++ b/lib/ansible/modules/network/ios/ios_user.py @@ -43,7 +43,8 @@ options: - The set of username objects to be configured on the remote Cisco IOS device. The list entries can either be the username or a hash of username and properties. This argument is mutually - exclusive with the C(name) argument. alias C(users). + exclusive with the C(name) argument. + aliases: ['users'] name: description: - The username to be configured on the Cisco IOS device. @@ -76,6 +77,7 @@ options: device running configuration. The argument accepts a string value defining the view name. This argument does not check if the view has been configured on the device. + aliases: ['role'] nopassword: description: - Defines the username without assigning diff --git a/lib/ansible/modules/network/iosxr/iosxr_user.py b/lib/ansible/modules/network/iosxr/iosxr_user.py index ff4fd70dc0..9bb2155f17 100644 --- a/lib/ansible/modules/network/iosxr/iosxr_user.py +++ b/lib/ansible/modules/network/iosxr/iosxr_user.py @@ -35,7 +35,8 @@ options: - The set of username objects to be configured on the remote Cisco IOS XR device. The list entries can either be the username or a hash of username and properties. This argument is mutually - exclusive with the C(name) argument, alias C(users). + exclusive with the C(name) argument. + aliases: ['users', 'collection'] name: description: - The username to be configured on the Cisco IOS XR device. @@ -62,7 +63,8 @@ options: - Configures the group for the username in the device running configuration. The argument accepts a string value defining the group name. This argument does not check if the group - has been configured on the device, alias C(role). + has been configured on the device. + aliases: ['role'] groups: version_added: "2.5" description: diff --git a/lib/ansible/modules/network/junos/junos_lldp.py b/lib/ansible/modules/network/junos/junos_lldp.py index 2b2e9c5adc..6a2b775774 100644 --- a/lib/ansible/modules/network/junos/junos_lldp.py +++ b/lib/ansible/modules/network/junos/junos_lldp.py @@ -35,12 +35,6 @@ options: - Specify the number of seconds that LLDP information is held before it is discarded. The multiplier value is used in combination with the C(interval) value. - enable: - description: - - If value is C(True) it enable LLDP protocol on remote device, if value - is C(False) it disables LLDP protocol. - default: present - choices: [True, False] state: description: - Value of C(present) ensures given LLDP configuration diff --git a/lib/ansible/modules/network/junos/junos_user.py b/lib/ansible/modules/network/junos/junos_user.py index 6c61839ec4..f936ff85e0 100644 --- a/lib/ansible/modules/network/junos/junos_user.py +++ b/lib/ansible/modules/network/junos/junos_user.py @@ -32,10 +32,11 @@ options: on the remote device. The list of users will be compared against the current users and only changes will be added or removed from the device configuration. This argument is mutually exclusive with - the name argument. alias C(users). + the name argument. version_added: "2.4" required: False default: null + aliases: ['users', 'collection'] name: description: - The C(name) argument defines the username of the user to be created diff --git a/lib/ansible/modules/network/nxos/_nxos_ip_interface.py b/lib/ansible/modules/network/nxos/_nxos_ip_interface.py index e8c20d7336..d900c53b42 100644 --- a/lib/ansible/modules/network/nxos/_nxos_ip_interface.py +++ b/lib/ansible/modules/network/nxos/_nxos_ip_interface.py @@ -73,6 +73,11 @@ options: required: false default: false version_added: "2.4" + include_defaults: + description: + - Specify if the complete running configuration for module operations should be used. + default: true + type: bool state: description: - Specify desired state of the resource. diff --git a/lib/ansible/modules/network/nxos/_nxos_portchannel.py b/lib/ansible/modules/network/nxos/_nxos_portchannel.py index 4f4796e20d..32c13911bc 100644 --- a/lib/ansible/modules/network/nxos/_nxos_portchannel.py +++ b/lib/ansible/modules/network/nxos/_nxos_portchannel.py @@ -68,6 +68,11 @@ options: required: false choices: ['true', 'false'] default: false + include_defaults: + description: + - Specify if the complete running configuration for module operations should be used. + default: false + type: bool state: description: - Manage the state of the resource. diff --git a/lib/ansible/modules/network/nxos/nxos_acl.py b/lib/ansible/modules/network/nxos/nxos_acl.py index 10750b275b..6cf9d7a438 100644 --- a/lib/ansible/modules/network/nxos/nxos_acl.py +++ b/lib/ansible/modules/network/nxos/nxos_acl.py @@ -172,7 +172,7 @@ options: required: false default: null choices: ['enable'] - time-range: + time_range: description: - Name of time-range to apply. required: false @@ -192,6 +192,11 @@ options: choices: ['af11', 'af12', 'af13', 'af21', 'af22', 'af23','af31','af32', 'af33', 'af41', 'af42', 'af43', 'cs1', 'cs2', 'cs3', 'cs4', 'cs5', 'cs6', 'cs7', 'default', 'ef'] + include_defaults: + description: + - Specify if the complete running configuration for module operations should be used. + default: false + type: bool state: description: - Specify desired state of the resource. diff --git a/lib/ansible/modules/network/nxos/nxos_evpn_vni.py b/lib/ansible/modules/network/nxos/nxos_evpn_vni.py index 8e31ca5a45..90b9bfabac 100644 --- a/lib/ansible/modules/network/nxos/nxos_evpn_vni.py +++ b/lib/ansible/modules/network/nxos/nxos_evpn_vni.py @@ -74,6 +74,11 @@ options: - Sets the route-target 'import' extended communities. required: false default: null + include_defaults: + description: + - Specify if the complete running configuration for module operations should be used. + default: true + type: bool state: description: - Determines whether the config should be present or not diff --git a/lib/ansible/modules/network/nxos/nxos_igmp.py b/lib/ansible/modules/network/nxos/nxos_igmp.py index 6812eba1a5..c62cc33a3c 100644 --- a/lib/ansible/modules/network/nxos/nxos_igmp.py +++ b/lib/ansible/modules/network/nxos/nxos_igmp.py @@ -59,6 +59,11 @@ options: required: false default: null choices: ['true', 'false'] + include_defaults: + description: + - Specify if the complete running configuration for module operations should be used. + default: false + type: bool state: description: - Manages desired state of the resource. diff --git a/lib/ansible/modules/network/nxos/nxos_igmp_interface.py b/lib/ansible/modules/network/nxos/nxos_igmp_interface.py index fe01bac3d0..489a229c1e 100644 --- a/lib/ansible/modules/network/nxos/nxos_igmp_interface.py +++ b/lib/ansible/modules/network/nxos/nxos_igmp_interface.py @@ -159,6 +159,11 @@ options: required: false choices: ['true', 'false'] default: null + include_defaults: + description: + - Specify if the complete running configuration for module operations should be used. + default: true + type: bool state: description: - Manages desired state of the resource. diff --git a/lib/ansible/modules/network/nxos/nxos_interface_ospf.py b/lib/ansible/modules/network/nxos/nxos_interface_ospf.py index 6aa0e1bf22..0468daf773 100644 --- a/lib/ansible/modules/network/nxos/nxos_interface_ospf.py +++ b/lib/ansible/modules/network/nxos/nxos_interface_ospf.py @@ -111,6 +111,11 @@ options: - Specifies the message_digest password. Valid value is a string. required: false default: null + include_defaults: + description: + - Specify if the complete running configuration for module operations should be used. + default: true + type: bool state: description: - Determines whether the config should be present or not diff --git a/lib/ansible/modules/network/nxos/nxos_ospf.py b/lib/ansible/modules/network/nxos/nxos_ospf.py index 54d4353e11..c9cb7f50ce 100644 --- a/lib/ansible/modules/network/nxos/nxos_ospf.py +++ b/lib/ansible/modules/network/nxos/nxos_ospf.py @@ -41,6 +41,11 @@ options: required: false default: present choices: ['present','absent'] + include_defaults: + description: + - Specify if the complete running configuration for module operations should be used. + default: true + type: bool ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/network/nxos/nxos_ospf_vrf.py b/lib/ansible/modules/network/nxos/nxos_ospf_vrf.py index 64ea711d00..929b513a70 100644 --- a/lib/ansible/modules/network/nxos/nxos_ospf_vrf.py +++ b/lib/ansible/modules/network/nxos/nxos_ospf_vrf.py @@ -120,6 +120,11 @@ options: required: false choices: ['true','false'] default: null + include_defaults: + description: + - Specify if the complete running configuration for module operations should be used. + default: true + type: bool ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/network/nxos/nxos_rollback.py b/lib/ansible/modules/network/nxos/nxos_rollback.py index 82ba28f494..e8757a4e0b 100644 --- a/lib/ansible/modules/network/nxos/nxos_rollback.py +++ b/lib/ansible/modules/network/nxos/nxos_rollback.py @@ -50,6 +50,11 @@ options: with checkpoint_file. required: false default: null + include_defaults: + description: + - Specify if the complete running configuration for module operations should be used. + default: false + type: bool ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/network/nxos/nxos_user.py b/lib/ansible/modules/network/nxos/nxos_user.py index a04950e2ce..8d6c6867de 100644 --- a/lib/ansible/modules/network/nxos/nxos_user.py +++ b/lib/ansible/modules/network/nxos/nxos_user.py @@ -40,14 +40,15 @@ options: - The set of username objects to be configured on the remote Cisco Nexus device. The list entries can either be the username or a hash of username and properties. This argument is mutually - exclusive with the C(name) argument. alias C(users). + exclusive with the C(name) argument. + aliases: ['users', 'collection'] version_added: "2.4" required: false default: null name: description: - The username to be configured on the remote Cisco Nexus - device. This argument accepts a stringv value and is mutually + device. This argument accepts a string value and is mutually exclusive with the C(aggregate) argument. required: false default: null @@ -76,6 +77,7 @@ options: has been configured on the device. required: false default: null + aliases: ['roles'] sshkey: description: - The C(sshkey) argument defines the SSH public key to configure diff --git a/lib/ansible/modules/network/nxos/nxos_vrrp.py b/lib/ansible/modules/network/nxos/nxos_vrrp.py index ec4966b82f..3c1d58239c 100644 --- a/lib/ansible/modules/network/nxos/nxos_vrrp.py +++ b/lib/ansible/modules/network/nxos/nxos_vrrp.py @@ -71,6 +71,11 @@ options: choices: ['shutdown', 'no shutdown'] default: no shutdown version_added: "2.2" + include_defaults: + description: + - Specify if the complete running configuration for module operations should be used. + default: false + type: bool state: description: - Specify desired state of the resource. diff --git a/lib/ansible/modules/network/ordnance/ordnance_config.py b/lib/ansible/modules/network/ordnance/ordnance_config.py index 51a303d826..92986cd59b 100644 --- a/lib/ansible/modules/network/ordnance/ordnance_config.py +++ b/lib/ansible/modules/network/ordnance/ordnance_config.py @@ -24,7 +24,7 @@ description: an implementation for working with these configuration sections in a deterministic way. options: - commands: + lines: description: - The ordered set of commands that should be configured in the section. The commands must be the exact same commands as found diff --git a/lib/ansible/modules/network/ovs/openvswitch_db.py b/lib/ansible/modules/network/ovs/openvswitch_db.py index 3c79cde466..95c3c8a143 100644 --- a/lib/ansible/modules/network/ovs/openvswitch_db.py +++ b/lib/ansible/modules/network/ovs/openvswitch_db.py @@ -43,7 +43,7 @@ options: required: true description: - Identifies the recoard in the table. - column: + col: required: true description: - Identifies the column in the record. diff --git a/lib/ansible/modules/network/vyos/vyos_system.py b/lib/ansible/modules/network/vyos/vyos_system.py index 12f607afd8..c17117ea03 100644 --- a/lib/ansible/modules/network/vyos/vyos_system.py +++ b/lib/ansible/modules/network/vyos/vyos_system.py @@ -36,7 +36,7 @@ extends_documentation_fragment: vyos notes: - Tested against VYOS 1.1.7 options: - hostname: + host_name: description: - Configure the device hostname parameter. This option takes an ASCII string value. domain_name: diff --git a/lib/ansible/modules/network/vyos/vyos_user.py b/lib/ansible/modules/network/vyos/vyos_user.py index 6dcdcc2286..b5fc76ed8a 100644 --- a/lib/ansible/modules/network/vyos/vyos_user.py +++ b/lib/ansible/modules/network/vyos/vyos_user.py @@ -43,7 +43,8 @@ options: - The set of username objects to be configured on the remote VyOS device. The list entries can either be the username or a hash of username and properties. This argument is mutually - exclusive with the C(name) argument. alias C(users). + exclusive with the C(name) argument. + aliases: ['users', 'collection'] name: description: - The username to be configured on the VyOS device. @@ -74,6 +75,7 @@ options: description: - The C(level) argument configures the level of the user when logged into the system. This argument accepts string values admin or operator. + aliases: ['role'] purge: description: - Instructs the module to consider the diff --git a/lib/ansible/modules/notification/mail.py b/lib/ansible/modules/notification/mail.py index 6fd83bc970..597a992758 100644 --- a/lib/ansible/modules/notification/mail.py +++ b/lib/ansible/modules/notification/mail.py @@ -42,6 +42,7 @@ options: - The email-address(es) the mail is being sent to. - This is a list, which may contain address and phrase portions. default: root + aliases: ['recipients'] cc: description: - The email-address(es) the mail is being copied to. diff --git a/lib/ansible/modules/notification/nexmo.py b/lib/ansible/modules/notification/nexmo.py index 78058e5cc8..38a5862e52 100644 --- a/lib/ansible/modules/notification/nexmo.py +++ b/lib/ansible/modules/notification/nexmo.py @@ -51,6 +51,8 @@ options: choices: - 'yes' - 'no' +extends_documentation_fragment: + - url """ EXAMPLES = """ diff --git a/lib/ansible/modules/packaging/language/composer.py b/lib/ansible/modules/packaging/language/composer.py index 4908136a3c..54c4adfbb0 100644 --- a/lib/ansible/modules/packaging/language/composer.py +++ b/lib/ansible/modules/packaging/language/composer.py @@ -83,7 +83,7 @@ options: - Disables all plugins ( see --no-plugins ). default: false choices: [ true, false] - aliases: [ no-plugin ] + aliases: [ no-plugins ] optimize_autoloader: description: - Optimize autoloader during autoloader dump (see --optimize-autoloader). diff --git a/lib/ansible/modules/packaging/os/apt.py b/lib/ansible/modules/packaging/os/apt.py index 0e8070ddde..0f57c8e559 100644 --- a/lib/ansible/modules/packaging/os/apt.py +++ b/lib/ansible/modules/packaging/os/apt.py @@ -55,6 +55,7 @@ options: description: - Corresponds to the C(--no-install-recommends) option for I(apt). C(yes) installs recommended packages. C(no) does not install recommended packages. By default, Ansible will use the same defaults as the operating system. Suggested packages are never installed. + aliases: ['install-recommends'] type: bool force: description: diff --git a/lib/ansible/modules/packaging/os/pulp_repo.py b/lib/ansible/modules/packaging/os/pulp_repo.py index cdaafb314a..18317e8480 100644 --- a/lib/ansible/modules/packaging/os/pulp_repo.py +++ b/lib/ansible/modules/packaging/os/pulp_repo.py @@ -22,7 +22,6 @@ short_description: Add or remove Pulp repos from a remote host. description: - Add or remove Pulp repos from a remote host. version_added: "2.3" -requirements: [] options: add_export_distributor: description: @@ -144,6 +143,8 @@ options: notes: - This module can currently only create distributors and importers on rpm repositories. Contributions to support other repo types are welcome. +extends_documentation_fragment: + - url ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/packaging/os/urpmi.py b/lib/ansible/modules/packaging/os/urpmi.py index c9c85ee59f..ba33b67b0e 100644 --- a/lib/ansible/modules/packaging/os/urpmi.py +++ b/lib/ansible/modules/packaging/os/urpmi.py @@ -41,6 +41,7 @@ options: - Corresponds to the C(--no-recommends) option for I(urpmi). type: bool default: 'yes' + aliases: ['no-recommends'] force: description: - Assume "yes" is the answer to any question urpmi has to ask. diff --git a/lib/ansible/modules/remote_management/imc/imc_rest.py b/lib/ansible/modules/remote_management/imc/imc_rest.py index 128b6da100..64774032af 100644 --- a/lib/ansible/modules/remote_management/imc/imc_rest.py +++ b/lib/ansible/modules/remote_management/imc/imc_rest.py @@ -46,7 +46,7 @@ options: - Name of the absolute path of the filename that includes the body of the http request being sent to the Cisco IMC REST API. - Parameter C(path) is mutual exclusive with parameter C(content). - aliases: [ src ] + aliases: [ 'src', 'config_file' ] content: description: - When used instead of C(path), sets the content of the API requests directly. diff --git a/lib/ansible/modules/remote_management/ucs/ucs_wwn_pool.py b/lib/ansible/modules/remote_management/ucs/ucs_wwn_pool.py index d52f257fe4..19b55ac3ed 100644 --- a/lib/ansible/modules/remote_management/ucs/ucs_wwn_pool.py +++ b/lib/ansible/modules/remote_management/ucs/ucs_wwn_pool.py @@ -38,7 +38,7 @@ options: - Optional if state is absent. choices: [node, port] required: yes - descrption: + description: description: - A description of the WWNN or WWPN pool. - Enter up to 256 characters. diff --git a/lib/ansible/modules/source_control/github_deploy_key.py b/lib/ansible/modules/source_control/github_deploy_key.py index 27a79c6786..cf650c7098 100644 --- a/lib/ansible/modules/source_control/github_deploy_key.py +++ b/lib/ansible/modules/source_control/github_deploy_key.py @@ -82,6 +82,7 @@ options: - The 6 digit One Time Password for 2-Factor Authentication. Required together with I(username) and I(password). required: false default: null + aliases: ['2fa_token'] requirements: - python-requests notes: diff --git a/lib/ansible/modules/storage/netapp/netapp_e_hostgroup.py b/lib/ansible/modules/storage/netapp/netapp_e_hostgroup.py index 63bd7fea7d..36b5f31a21 100644 --- a/lib/ansible/modules/storage/netapp/netapp_e_hostgroup.py +++ b/lib/ansible/modules/storage/netapp/netapp_e_hostgroup.py @@ -60,7 +60,7 @@ options: required: false description: - The id number of the host group to manage. Either this or C(name) must be supplied. - hosts:: + hosts: required: false description: - a list of host names/labels to add to the group diff --git a/lib/ansible/modules/system/gluster_volume.py b/lib/ansible/modules/system/gluster_volume.py index 3ede8a9023..816a8f7e13 100644 --- a/lib/ansible/modules/system/gluster_volume.py +++ b/lib/ansible/modules/system/gluster_volume.py @@ -37,7 +37,7 @@ options: replicas: description: - Replica count for volume. - arbiter: + arbiters: description: - Arbiter count for volume. version_added: '2.3' diff --git a/lib/ansible/modules/system/selinux.py b/lib/ansible/modules/system/selinux.py index 917304ec2a..1385af0cbd 100644 --- a/lib/ansible/modules/system/selinux.py +++ b/lib/ansible/modules/system/selinux.py @@ -39,6 +39,7 @@ options: - path to the SELinux configuration file, if non-standard required: false default: "/etc/selinux/config" + aliases: ['configfile', 'file'] notes: - Not tested on any debian based system requirements: [ libselinux-python ] diff --git a/lib/ansible/modules/web_infrastructure/django_manage.py b/lib/ansible/modules/web_infrastructure/django_manage.py index 01eabe7256..dafa698951 100644 --- a/lib/ansible/modules/web_infrastructure/django_manage.py +++ b/lib/ansible/modules/web_infrastructure/django_manage.py @@ -45,7 +45,7 @@ options: virtualenv: description: - An optional path to a I(virtualenv) installation to use while running the manage application. - required: false + aliases: [virtualenv] apps: description: - A list of space-delimited apps to target. Used by the 'test' command. diff --git a/lib/ansible/modules/web_infrastructure/jenkins_plugin.py b/lib/ansible/modules/web_infrastructure/jenkins_plugin.py index 693b27d2a1..aaad1189fe 100644 --- a/lib/ansible/modules/web_infrastructure/jenkins_plugin.py +++ b/lib/ansible/modules/web_infrastructure/jenkins_plugin.py @@ -114,6 +114,8 @@ notes: host where Jenkins runs as it needs direct access to the plugin files. - "The C(params) option was removed in Ansible 2.5 due to circumventing Ansible's option handling" +extends_documentation_fragment: + - url ''' EXAMPLES = ''' diff --git a/lib/ansible/modules/web_infrastructure/jira.py b/lib/ansible/modules/web_infrastructure/jira.py index e37d6c08e2..8701421912 100644 --- a/lib/ansible/modules/web_infrastructure/jira.py +++ b/lib/ansible/modules/web_infrastructure/jira.py @@ -46,7 +46,6 @@ options: - The password to log-in with. project: - aliases: [ prj ] required: false description: - The project for this operation. Required for issue creation. diff --git a/lib/ansible/utils/module_docs_fragments/f5.py b/lib/ansible/utils/module_docs_fragments/f5.py index b2cb5c99b1..6ab6f81982 100644 --- a/lib/ansible/utils/module_docs_fragments/f5.py +++ b/lib/ansible/utils/module_docs_fragments/f5.py @@ -26,6 +26,7 @@ options: You can omit this option if the environment variable C(F5_PASSWORD) is set. required: true + aliases: ['pass', 'pwd'] server: description: - The BIG-IP host. You can omit this option if the environment diff --git a/lib/ansible/utils/module_docs_fragments/netapp.py b/lib/ansible/utils/module_docs_fragments/netapp.py index 2a71b0c06d..3629f2c453 100644 --- a/lib/ansible/utils/module_docs_fragments/netapp.py +++ b/lib/ansible/utils/module_docs_fragments/netapp.py @@ -40,10 +40,12 @@ options: description: - This can be a Cluster-scoped or SVM-scoped account, depending on whether a Cluster-level or SVM-level API is required. For more information, please read the documentation U(https://goo.gl/BRu78Z). + aliases: ['user'] password: required: true description: - Password for the specified user. + aliases: ['pass'] requirements: - A physical or virtual clustered Data ONTAP system. The modules were developed with Clustered Data ONTAP 8.3 diff --git a/lib/ansible/utils/module_docs_fragments/url.py b/lib/ansible/utils/module_docs_fragments/url.py new file mode 100644 index 0000000000..d1e879562d --- /dev/null +++ b/lib/ansible/utils/module_docs_fragments/url.py @@ -0,0 +1,72 @@ +# (c) 2018, John Barker +# +# This file is part of Ansible +# +# Ansible is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# Ansible is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with Ansible. If not, see . + + +class ModuleDocFragment(object): + + # Standard files documentation fragment + DOCUMENTATION = """ +options: + url: + description: + - HTTP, HTTPS, or FTP URL in the form (http|https|ftp)://[user[:pass]]@host.domain[:port]/path + force: + description: + - If C(yes) do not get a cached copy. + aliases: + - thirsty + type: bool + default: no + http_agent: + description: + - Header to identify as, generally appears in web server logs. + default: ansible-httpget + use_proxy: + description: + - If C(no), it will not use a proxy, even if one is defined in an environment variable on the target hosts. + type: bool + default: yes + validate_certs: + description: + - If C(no), SSL certificates will not be validated. This should only be used + on personally controlled sites using self-signed certificates. + default: yes + type: bool + url_username: + description: + - The username for use in HTTP basic authentication. + - This parameter can be used without I(url_password) for sites that allow empty passwords + url_password: + description: + - The password for use in HTTP basic authentication. + - If the I(url_username) parameter is not specified, the I(url_password) parameter will not be used. + force_basic_auth: + description: + - Credentials specified with I(url_username) and I(url_password) should be passed in HTTP Header. + default: no + type: bool + client_cert: + description: + - PEM formatted certificate chain file to be used for SSL client + authentication. This file can also include the key as well, and if + the key is included, C(client_key) is not required. + client_key: + description: + - PEM formatted file that contains your private key to be used for SSL + client authentication. If C(client_cert) contains both the certificate + and key, this option is not required. +""" diff --git a/lib/ansible/utils/module_docs_fragments/vca.py b/lib/ansible/utils/module_docs_fragments/vca.py index 1fad1de18f..a7a673f3b7 100644 --- a/lib/ansible/utils/module_docs_fragments/vca.py +++ b/lib/ansible/utils/module_docs_fragments/vca.py @@ -31,7 +31,7 @@ options: - The vca password, if not set the environment variable C(VCA_PASS) is checked for the password. required: false default: None - aliases: ['pass', 'pwd'] + aliases: ['pass', 'passwd'] org: description: - The org to login to for creating vapp. This option is required when the C(service_type) is I(vdc).