diff --git a/lib/ansible/modules/cloud/amazon/_ec2_ami_find.py b/lib/ansible/modules/cloud/amazon/_ec2_ami_find.py index 324405647ad..9c7c5d8c45c 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 0ad2244824a..5a606fc5b2d 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 79e469c4aa4..880dc610bfb 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 04bc5b45e6b..0524385d9e0 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 04e7283090c..85df59785ec 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 a849627c049..79de295a6b0 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 83a62a2fd5a..28e9261fc99 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 4a0f55fa65a..e41748bf9db 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 18f7ddc351d..908d83f88a3 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 9b0f97c732b..da12f3530ae 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 03f2ce68769..49ec93e7e0d 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 d7033ccb240..4d13a64f862 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 d703571c8f6..c1266473674 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 7622aafb2d7..959de2c5c00 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 d33e9cb5dd4..a439b6f14a6 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 7b11f7d61d8..4f32e79209f 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 27979744eb3..61cdc4f18c8 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 fceff34b655..75bd846f0c0 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 0f6bdbf5625..2dcde18eff8 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 179dadc2535..b87efe93dfa 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 53c954acc46..a2d2793ffd8 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 c7e4b526712..64df287aa23 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 3c53034fa06..94d84c18cce 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 3a20749acc6..7dd4fe5713c 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 3cd525d44d3..45d5e5fa396 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 9b286ca4059..5d65db0debd 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 7b9760b6691..30aa884bedf 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 e0c9be5ac1b..880f476a674 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 d2fc1ac8c8c..8d48141486a 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 2f4292c2eaa..c1307c492c9 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 66c47001895..d8e8cffbc72 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 3659dcf49c8..9f9d49aa8ae 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 a4c3ef37e84..8eb673d55ff 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 01b160b40c7..a12981d7828 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 6484c0993aa..c5d58698a89 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 21ccf29fc50..71137e099e7 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 c9b6057aeec..5b6045ef990 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 0acc0daacec..03a647f9055 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 e8584b435bc..7ddcd757c99 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 b01170388cc..9a3a27dd7e1 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 0d8e40e7a51..74c8769757c 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 fe846c1ccad..f0e491b90a8 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 7fd60f489f1..4ca9277422e 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 fe7c1115ee3..474ac3d938e 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 59a0ed90f72..4f2c1b5c7bc 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 f3049eb8483..6936aaaeff6 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 ce17e3bf610..258d37fc113 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 5568915c673..3e0f9017f12 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 2fe1452f058..59a6c3ccda1 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 5d314f35c42..30a318520c9 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 0406f9ea884..6e1518b758d 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 ced43696760..7261c2dcaa7 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 443e0389711..5969e7448ee 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 0180265fcff..eac23bd0165 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 f00bd5e63e8..d539934f4e9 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 48bf02a6645..68426656f78 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 6dfee788175..92a5188a331 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 1a0aaba6f6b..e3f78358000 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 6ed9b4fdc8b..8bf0d2c6247 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 771bde39b86..68742d3f897 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 465157a63f5..9138cacc660 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 129c6d5c4f8..a83dd36826e 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 ff51218e6a7..2ba30a11b6b 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 6e56c762ab4..0db7a5758b8 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 3a868248c4b..ced3bde0fd8 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 45fa4c3bd33..c76ae8ac5b2 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 9f64763adce..7a21623c9ee 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 e889cb315b5..098882c04d2 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 b4734edf52f..485d1beef8f 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 f7891cf8a21..a1bb77ddb8b 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 64b5a3540d0..8e8951dc30b 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 a63cd28a339..dc3dcb3645b 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 c007a9128a2..1c3afea6262 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 0f5c51d5c51..0a7c1fa6f7b 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 2cba7cb4df0..db18711f393 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 0364b8f52ee..5a2a11e519a 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 ff01e756906..2159a33b100 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 380dc175c51..1d1f6bbeb80 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 45cfcfcf16e..574c89d3137 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 3ab319f5e70..05b24fbd051 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 2b8d0bf9a72..627c14c96cf 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 74b0e197bfe..9f5ac5fe945 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 274436c893f..bc37102a1f0 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 93ed8faf212..3e008a303f4 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 673eea848aa..243df781d74 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 ff4fd70dc06..9bb2155f170 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 2b2e9c5adc5..6a2b775774f 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 6c61839ec4f..f936ff85e09 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 e8c20d73369..d900c53b426 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 4f4796e20d1..32c13911bc0 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 10750b275b8..6cf9d7a438b 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 8e31ca5a457..90b9bfabacf 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 6812eba1a54..c62cc33a3c5 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 fe01bac3d02..489a229c1e8 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 6aa0e1bf22d..0468daf7736 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 54d4353e11e..c9cb7f50ce9 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 64ea711d004..929b513a702 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 82ba28f4941..e8757a4e0bc 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 a04950e2ce9..8d6c6867de1 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 ec4966b82f8..3c1d58239cf 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 51a303d8265..92986cd59ba 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 3c79cde4663..95c3c8a1430 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 12f607afd8a..c17117ea03e 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 6dcdcc2286c..b5fc76ed8ae 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 6fd83bc9701..597a992758b 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 78058e5cc85..38a5862e52f 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 4908136a3c2..54c4adfbb0b 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 0e8070dddef..0f57c8e5597 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 cdaafb314a5..18317e8480c 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 c9c85ee59f8..ba33b67b0ee 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 128b6da1000..64774032af1 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 d52f257fe4d..19b55ac3edb 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 27a79c67864..cf650c7098a 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 63bd7fea7de..36b5f31a21e 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 3ede8a9023b..816a8f7e133 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 917304ec2a7..1385af0cbdc 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 01eabe7256f..dafa698951d 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 693b27d2a1f..aaad1189fee 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 e37d6c08e2b..87014219129 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 b2cb5c99b1e..6ab6f819826 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 2a71b0c06d9..3629f2c4538 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 00000000000..d1e879562df --- /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 1fad1de18f6..a7a673f3b71 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).