From 42bf6ed2076ffed1af7bdbf3ab2294303316ef20 Mon Sep 17 00:00:00 2001 From: Mark Chappell Date: Sun, 6 Dec 2020 17:40:44 +0100 Subject: [PATCH] General docs cleanup --- plugins/modules/aws_api_gateway.py | 23 ++++---- .../modules/aws_application_scaling_policy.py | 10 ++-- .../modules/aws_direct_connect_connection.py | 4 +- plugins/modules/cloudfront_distribution.py | 20 +++---- plugins/modules/ec2_ami_copy.py | 9 +-- plugins/modules/ec2_vpc_vpn.py | 20 +++---- plugins/modules/ecs_ecr.py | 4 +- plugins/modules/ecs_service.py | 13 ++-- plugins/modules/ecs_taskdefinition.py | 2 +- plugins/modules/elasticache.py | 8 +-- plugins/modules/elb_application_lb.py | 12 ++-- plugins/modules/elb_classic_lb.py | 59 ++++++++++--------- plugins/modules/elb_target.py | 16 ++--- plugins/modules/iam_cert.py | 8 +-- plugins/modules/route53.py | 16 ++--- plugins/modules/sqs_queue.py | 2 +- 16 files changed, 116 insertions(+), 110 deletions(-) diff --git a/plugins/modules/aws_api_gateway.py b/plugins/modules/aws_api_gateway.py index c618c38d4e4..f7466b1d1e2 100644 --- a/plugins/modules/aws_api_gateway.py +++ b/plugins/modules/aws_api_gateway.py @@ -14,7 +14,7 @@ version_added: 1.0.0 short_description: Manage AWS API Gateway APIs description: - - Allows for the management of API Gateway APIs + - Allows for the management of API Gateway APIs. - Normally you should give the api_id since there is no other stable guaranteed unique identifier for the API. If you do not give api_id then a new API will be created each time @@ -40,7 +40,7 @@ swagger_file: description: - JSON or YAML file containing swagger definitions for API. - Exactly one of swagger_file, swagger_text or swagger_dict must + Exactly one of I(swagger_file), I(swagger_text) or I(swagger_dict) must be present. type: path aliases: ['src', 'api_file'] @@ -60,13 +60,13 @@ type: str deploy_desc: description: - - Description of the deployment - recorded and visible in the - AWS console. + - Description of the deployment. + - Recorded and visible in the AWS console. default: Automatic deployment by Ansible. type: str cache_enabled: description: - - Enable API GW caching of backend responses. Defaults to false. + - Enable API GW caching of backend responses. type: bool default: false cache_size: @@ -83,10 +83,10 @@ description: - Canary settings for the deployment of the stage. - 'Dict with following settings:' - - 'percentTraffic: The percent (0-100) of traffic diverted to a canary deployment.' - - 'deploymentId: The ID of the canary deployment.' - - 'stageVariableOverrides: Stage variables overridden for a canary release deployment.' - - 'useStageCache: A Boolean flag to indicate whether the canary deployment uses the stage cache or not.' + - 'C(percentTraffic): The percent (0-100) of traffic diverted to a canary deployment.' + - 'C(deploymentId): The ID of the canary deployment.' + - 'C(stageVariableOverrides): Stage variables overridden for a canary release deployment.' + - 'C(useStageCache): A Boolean flag to indicate whether the canary deployment uses the stage cache or not.' - See docs U(https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/apigateway.html#APIGateway.Client.create_stage) type: dict tracing_enabled: @@ -96,8 +96,9 @@ default: false endpoint_type: description: - - Type of endpoint configuration, use C(EDGE) for an edge optimized API endpoint, - - C(REGIONAL) for just a regional deploy or PRIVATE for a private API. + - Type of endpoint configuration. + - Use C(EDGE) for an edge optimized API endpoint, + C(REGIONAL) for just a regional deploy or C(PRIVATE) for a private API. - This flag will only be used when creating a new API Gateway setup, not for updates. choices: ['EDGE', 'REGIONAL', 'PRIVATE'] type: str diff --git a/plugins/modules/aws_application_scaling_policy.py b/plugins/modules/aws_application_scaling_policy.py index 79d23c70aed..dcc8b8b1691 100644 --- a/plugins/modules/aws_application_scaling_policy.py +++ b/plugins/modules/aws_application_scaling_policy.py @@ -15,14 +15,14 @@ - for details of the parameters and returns see U(http://boto3.readthedocs.io/en/latest/reference/services/application-autoscaling.html#ApplicationAutoScaling.Client.put_scaling_policy) description: - - Creates, updates or removes a Scaling Policy + - Creates, updates or removes a Scaling Policy. author: - Gustavo Maia (@gurumaia) - Chen Leibovich (@chenl87) requirements: [ json, botocore, boto3 ] options: state: - description: Whether a policy should be present or absent + description: Whether a policy should be C(present) or C(absent). required: yes choices: ['absent', 'present'] type: str @@ -57,12 +57,12 @@ choices: ['StepScaling', 'TargetTrackingScaling'] type: str step_scaling_policy_configuration: - description: A step scaling policy. This parameter is required if you are creating a policy and the policy type is StepScaling. + description: A step scaling policy. This parameter is required if you are creating a policy and I(policy_type=StepScaling). required: no type: dict target_tracking_scaling_policy_configuration: description: - - A target tracking policy. This parameter is required if you are creating a new policy and the policy type is TargetTrackingScaling. + - A target tracking policy. This parameter is required if you are creating a new policy and I(policy_type=TargetTrackingScaling). - 'Full documentation of the suboptions can be found in the API documentation:' - 'U(https://docs.aws.amazon.com/autoscaling/application/APIReference/API_TargetTrackingScalingPolicyConfiguration.html)' required: no @@ -84,7 +84,7 @@ description: The time (in seconds) to wait after scaling-out before another scaling action can occur. type: int TargetValue: - description: The target value for the metric + description: The target value for the metric. type: float minimum_tasks: description: The minimum value to scale to in response to a scale in event. diff --git a/plugins/modules/aws_direct_connect_connection.py b/plugins/modules/aws_direct_connect_connection.py index b4af11692c4..e7eff3f4197 100644 --- a/plugins/modules/aws_direct_connect_connection.py +++ b/plugins/modules/aws_direct_connect_connection.py @@ -64,8 +64,8 @@ type: str 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. + - To modify I(bandwidth) or I(location) the connection needs to be deleted and recreated. + - By default this will not happen. This option must be explicitly set to C(True) to change I(bandwith) or I(location). type: bool default: false ''' diff --git a/plugins/modules/cloudfront_distribution.py b/plugins/modules/cloudfront_distribution.py index c6c571fb9e4..a48f687a890 100644 --- a/plugins/modules/cloudfront_distribution.py +++ b/plugins/modules/cloudfront_distribution.py @@ -66,7 +66,7 @@ tags: description: - Should be input as a dict of key-value pairs. - - Note that numeric keys or values must be wrapped in quotes. e.g. "Priority:" '1' + - "Note that numeric keys or values must be wrapped in quotes. e.g. C(Priority: '1')" type: dict purge_tags: @@ -87,7 +87,7 @@ aliases: description: - - A list) of domain name aliases (CNAMEs) as strings to be used for the distribution. + - A list of domain name aliases (CNAMEs) as strings to be used for the distribution. - Each alias must be unique across all distribution for the AWS account. type: list elements: str @@ -141,7 +141,7 @@ description: - Custom headers you wish to add to the request before passing it to the origin. - For more information see the CloudFront documentation - at U(https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/forward-custom-headers.html) + at U(https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/forward-custom-headers.html). type: list elements: dict suboptions: @@ -191,7 +191,7 @@ description: - A dict specifying the default cache behavior of the distribution. - If not specified, the I(target_origin_id) is defined as the I(target_origin_id) of the first valid - I(cache_behavior) in I(cache_behaviors) with defaults. + cache_behavior in I(cache_behaviors) with defaults. suboptions: target_origin_id: description: @@ -504,18 +504,18 @@ type: bool description: - If you're using the CloudFront domain name for your distribution, such as C(123456789abcde.cloudfront.net) - you should set I(cloudfront_default_certificate=true) + you should set I(cloudfront_default_certificate=true). - If I(cloudfront_default_certificate=true) do not set I(ssl_support_method). iam_certificate_id: type: str description: - The ID of a certificate stored in IAM to use for HTTPS connections. - - If I(iam_certificate_id) is set then you must also specify I(ssl_support_method) + - If I(iam_certificate_id) is set then you must also specify I(ssl_support_method). acm_certificate_arn: type: str description: - The ID of a certificate stored in ACM to use for HTTPS connections. - - If I(acm_certificate_id) is set then you must also specify I(ssl_support_method) + - If I(acm_certificate_id) is set then you must also specify I(ssl_support_method). ssl_support_method: type: str description: @@ -541,12 +541,12 @@ type: str description: - The method that you want to use to restrict distribution of your content by country. - - Valid values are C(none), C(whitelist), C(blacklist) + - Valid values are C(none), C(whitelist), C(blacklist). items: description: - A list of ISO 3166-1 two letter (Alpha 2) country codes that the restriction should apply to. - - 'See the ISO website for a full list of codes U(https://www.iso.org/obp/ui/#search/code/)' + - 'See the ISO website for a full list of codes U(https://www.iso.org/obp/ui/#search/code/).' type: list web_acl_id: @@ -558,7 +558,7 @@ description: - The version of the http protocol to use for the distribution. - AWS defaults this to C(http2). - - Valid values are C(http1.1) and C(http2) + - Valid values are C(http1.1) and C(http2). type: str ipv6_enabled: diff --git a/plugins/modules/ec2_ami_copy.py b/plugins/modules/ec2_ami_copy.py index 1d21031f2f7..38f1123168f 100644 --- a/plugins/modules/ec2_ami_copy.py +++ b/plugins/modules/ec2_ami_copy.py @@ -27,7 +27,7 @@ type: str name: description: - - The name of the new AMI to copy. (As of 2.3 the default is 'default', in prior versions it was 'null'.) + - The name of the new AMI to copy. (As of 2.3 the default is C(default), in prior versions it was C(null).) default: "default" type: str description: @@ -45,14 +45,15 @@ type: str wait: description: - - Wait for the copied AMI to be in state 'available' before returning. + - Wait for the copied AMI to be in state C(available) before returning. type: bool default: 'no' wait_timeout: description: - - How long before wait gives up, in seconds. Prior to 2.3 the default was 1200. + - How long before wait gives up, in seconds. + - Prior to 2.3 the default was C(1200). - From 2.3-2.5 this option was deprecated in favor of boto3 waiter defaults. - This was reenabled in 2.6 to allow timeouts greater than 10 minutes. + - This was reenabled in 2.6 to allow timeouts greater than 10 minutes. default: 600 type: int tags: diff --git a/plugins/modules/ec2_vpc_vpn.py b/plugins/modules/ec2_vpc_vpn.py index c7aafe02a6f..6e18e724258 100644 --- a/plugins/modules/ec2_vpc_vpn.py +++ b/plugins/modules/ec2_vpc_vpn.py @@ -35,7 +35,7 @@ connection_type: description: - The type of VPN connection. - - At this time only 'ipsec.1' is supported. + - At this time only C(ipsec.1) is supported. default: ipsec.1 type: str vpn_gateway_id: @@ -63,8 +63,8 @@ required: no tunnel_options: description: - - An optional list object containing no more than two dict members, each of which may contain 'TunnelInsideCidr' - and/or 'PreSharedKey' keys with appropriate string values. AWS defaults will apply in absence of either of + - An optional list object containing no more than two dict members, each of which may contain I(TunnelInsideCidr) + and/or I(PreSharedKey) keys with appropriate string values. AWS defaults will apply in absence of either of the aforementioned keys. required: no type: list @@ -78,11 +78,11 @@ description: The pre-shared key (PSK) to establish initial authentication between the virtual private gateway and customer gateway. filters: description: - - An alternative to using vpn_connection_id. If multiple matches are found, vpn_connection_id is required. + - An alternative to using I(vpn_connection_id). If multiple matches are found, vpn_connection_id is required. If one of the following suboptions is a list of items to filter by, only one item needs to match to find the VPN - that correlates. e.g. if the filter 'cidr' is ['194.168.2.0/24', '192.168.2.0/24'] and the VPN route only has the - destination cidr block of '192.168.2.0/24' it will be found with this filter (assuming there are not multiple - VPNs that are matched). Another example, if the filter 'vpn' is equal to ['vpn-ccf7e7ad', 'vpn-cb0ae2a2'] and one + that correlates. e.g. if the filter I(cidr) is C(['194.168.2.0/24', '192.168.2.0/24']) and the VPN route only has the + destination cidr block of C(192.168.2.0/24) it will be found with this filter (assuming there are not multiple + VPNs that are matched). Another example, if the filter I(vpn) is equal to C(['vpn-ccf7e7ad', 'vpn-cb0ae2a2']) and one of of the VPNs has the state deleted (exists but is unmodifiable) and the other exists and is not deleted, it will be found via this filter. See examples. suboptions: @@ -91,7 +91,7 @@ - The customer gateway configuration of the VPN as a string (in the format of the return value) or a list of those strings. static-routes-only: description: - - The type of routing; true or false. + - The type of routing; C(true) or C(false). cidr: description: - The destination cidr of the VPN's route as a string or a list of those strings. @@ -130,13 +130,13 @@ default: false wait_timeout: description: - - How long before wait gives up, in seconds. + - How long, in seconds, before wait gives up. default: 600 type: int required: false delay: description: - - The time to wait before checking operation again. in seconds. + - The time, in seconds, to wait before checking operation again. required: false type: int default: 15 diff --git a/plugins/modules/ecs_ecr.py b/plugins/modules/ecs_ecr.py index 4e5b2f4a650..4ae7d40cd2a 100644 --- a/plugins/modules/ecs_ecr.py +++ b/plugins/modules/ecs_ecr.py @@ -63,7 +63,7 @@ type: json purge_lifecycle_policy: description: - - if yes, remove the lifecycle policy from the repository. + - if C(true), remove the lifecycle policy from the repository. - Defaults to C(false). required: false type: bool @@ -76,7 +76,7 @@ type: str scan_on_push: description: - - if yes, images are scanned for known vulnerabilities after being pushed to the repository. + - if C(true), images are scanned for known vulnerabilities after being pushed to the repository. - I(scan_on_push) requires botocore >= 1.13.3 required: false default: false diff --git a/plugins/modules/ecs_service.py b/plugins/modules/ecs_service.py index 6f6c2c0ece9..7bc3d467df7 100644 --- a/plugins/modules/ecs_service.py +++ b/plugins/modules/ecs_service.py @@ -137,12 +137,12 @@ suboptions: subnets: description: - - A list of subnet IDs to associate with the task + - A list of subnet IDs to associate with the task. type: list elements: str security_groups: description: - - A list of security group names or group IDs to associate with the task + - A list of security group names or group IDs to associate with the task. type: list elements: str assign_public_ip: @@ -171,19 +171,20 @@ suboptions: container_name: description: - - container name for service discovery registration + - Container name for service discovery registration. type: str container_port: description: - - container port for service discovery registration + - Container port for service discovery registration. type: int arn: description: - - Service discovery registry ARN + - Service discovery registry ARN. type: str scheduling_strategy: description: - - The scheduling strategy, defaults to "REPLICA" if not given to preserve previous behavior + - The scheduling strategy. + - Defaults to C(REPLICA) if not given to preserve previous behavior. required: false choices: ["DAEMON", "REPLICA"] type: str diff --git a/plugins/modules/ecs_taskdefinition.py b/plugins/modules/ecs_taskdefinition.py index 8f60eff6784..6158fb4ec21 100644 --- a/plugins/modules/ecs_taskdefinition.py +++ b/plugins/modules/ecs_taskdefinition.py @@ -96,7 +96,7 @@ memory: description: - The amount (in MiB) of memory used by the task. If using the EC2 launch type, this field is optional and any value can be used. - - If using the Fargate launch type, this field is required and is limited by the cpu. + - If using the Fargate launch type, this field is required and is limited by the CPU. required: false type: str extends_documentation_fragment: diff --git a/plugins/modules/elasticache.py b/plugins/modules/elasticache.py index 0aa132fdcda..d6a649ba17b 100644 --- a/plugins/modules/elasticache.py +++ b/plugins/modules/elasticache.py @@ -64,17 +64,17 @@ type: str cache_subnet_group: description: - - The subnet group name to associate with. Only use if inside a vpc. - - Required if inside a vpc + - The subnet group name to associate with. Only use if inside a VPC. + - Required if inside a VPC. type: str security_group_ids: description: - - A list of vpc security group IDs to associate with this cache cluster. Only use if inside a vpc. + - A list of VPC security group IDs to associate with this cache cluster. Only use if inside a VPC. type: list elements: str cache_security_groups: description: - - A list of cache security group names to associate with this cache cluster. Must be an empty list if inside a vpc. + - A list of cache security group names to associate with this cache cluster. Must be an empty list if inside a VPC. type: list elements: str zone: diff --git a/plugins/modules/elb_application_lb.py b/plugins/modules/elb_application_lb.py index d99cd864dd8..f18a00816b8 100644 --- a/plugins/modules/elb_application_lb.py +++ b/plugins/modules/elb_application_lb.py @@ -22,7 +22,7 @@ --- module: elb_application_lb version_added: 1.0.0 -short_description: Manage an Application load balancer +short_description: Manage an Application Load Balancer description: - Manage an AWS Application Elastic Load Balancer. See U(https://aws.amazon.com/blogs/aws/new-aws-application-load-balancer/) for details. requirements: [ boto3 ] @@ -124,14 +124,14 @@ type: str purge_listeners: description: - - If yes, existing listeners will be purged from the ELB to match exactly what is defined by I(listeners) parameter. If the I(listeners) parameter is - not set then listeners will not be modified + - If C(yes), existing listeners will be purged from the ELB to match exactly what is defined by I(listeners) parameter. + - If the I(listeners) parameter is not set then listeners will not be modified. default: yes type: bool purge_tags: description: - - If yes, existing tags will be purged from the resource to match exactly what is defined by I(tags) parameter. If the I(tags) parameter is not set then - tags will not be modified. + - If yes, existing tags will be purged from the resource to match exactly what is defined by I(tags) parameter. + - If the I(tags) parameter is not set then tags will not be modified. default: yes type: bool subnets: @@ -176,7 +176,7 @@ type: int purge_rules: description: - - When set to no, keep the existing load balancer rules in place. Will modify and add, but will not delete. + - When set to C(no), keep the existing load balancer rules in place. Will modify and add, but will not delete. default: yes type: bool extends_documentation_fragment: diff --git a/plugins/modules/elb_classic_lb.py b/plugins/modules/elb_classic_lb.py index aa26ca21e10..cd7d45875d1 100644 --- a/plugins/modules/elb_classic_lb.py +++ b/plugins/modules/elb_classic_lb.py @@ -19,62 +19,62 @@ options: state: description: - - Create or destroy the ELB + - Create or destroy the ELB. choices: ["present", "absent"] required: true type: str name: description: - - The name of the ELB + - The name of the ELB. required: true type: str listeners: description: - - List of ports/protocols for this ELB to listen on (see example) + - List of ports/protocols for this ELB to listen on (see example). type: list elements: dict purge_listeners: description: - - Purge existing listeners on ELB that are not found in listeners + - Purge existing listeners on ELB that are not found in listeners. type: bool - default: 'yes' + default: true instance_ids: description: - - List of instance ids to attach to this ELB + - List of instance ids to attach to this ELB. type: list elements: str purge_instance_ids: description: - - Purge existing instance ids on ELB that are not found in instance_ids + - Purge existing instance ids on ELB that are not found in I(instance_ids). type: bool - default: 'no' + default: false zones: description: - - List of availability zones to enable on this ELB + - List of availability zones to enable on this ELB. type: list elements: str purge_zones: description: - - Purge existing availability zones on ELB that are not found in zones + - Purge existing availability zones on ELB that are not found in zones. type: bool - default: 'no' + default: false security_group_ids: description: - - A list of security groups to apply to the elb + - A list of security groups to apply to the ELB. type: list elements: str security_group_names: description: - - A list of security group names to apply to the elb + - A list of security group names to apply to the ELB. type: list elements: str health_check: description: - - An associative array of health check configuration settings (see example) + - An associative array of health check configuration settings (see example). type: dict access_logs: description: - - An associative array of access logs configuration settings (see example) + - An associative array of access logs configuration settings (see example). type: dict subnets: description: @@ -83,49 +83,50 @@ elements: str purge_subnets: description: - - Purge existing subnet on ELB that are not found in subnets + - Purge existing subnets on ELB that are not found in subnets. type: bool - default: 'no' + default: false scheme: description: - - The scheme to use when creating the ELB. For a private VPC-visible ELB use 'internal'. - If you choose to update your scheme with a different value the ELB will be destroyed and - recreated. To update scheme you must use the option wait. + - The scheme to use when creating the ELB. + - For a private VPC-visible ELB use C(internal). + - If you choose to update your scheme with a different value the ELB will be destroyed and + recreated. To update scheme you must set I(wait=true). choices: ["internal", "internet-facing"] default: 'internet-facing' type: str validate_certs: description: - - When set to C(no), SSL certificates will not be validated for boto versions >= 2.6.0. + - When set to C(false), SSL certificates will not be validated for boto versions >= 2.6.0. type: bool - default: 'yes' + default: true connection_draining_timeout: description: - - Wait a specified timeout allowing connections to drain before terminating an instance + - Wait a specified timeout allowing connections to drain before terminating an instance. type: int idle_timeout: description: - - ELB connections from clients and to servers are timed out after this amount of time + - ELB connections from clients and to servers are timed out after this amount of time. type: int cross_az_load_balancing: description: - - Distribute load across all configured Availability Zones + - Distribute load across all configured Availability Zones. - Defaults to C(false). type: bool stickiness: description: - - An associative array of stickiness policy settings. Policy will be applied to all listeners ( see example ) + - An associative array of stickiness policy settings. Policy will be applied to all listeners (see example). type: dict wait: description: - When specified, Ansible will check the status of the load balancer to ensure it has been successfully removed from AWS. type: bool - default: 'no' + default: false wait_timeout: description: - - Used in conjunction with wait. Number of seconds to wait for the elb to be terminated. - A maximum of 600 seconds (10 minutes) is allowed. + - Used in conjunction with wait. Number of seconds to wait for the ELB to be terminated. + A maximum of C(600) seconds (10 minutes) is allowed. default: 60 type: int tags: diff --git a/plugins/modules/elb_target.py b/plugins/modules/elb_target.py index e23142c2039..b8cda233814 100644 --- a/plugins/modules/elb_target.py +++ b/plugins/modules/elb_target.py @@ -12,28 +12,30 @@ version_added: 1.0.0 short_description: Manage a target in a target group description: - - Used to register or deregister a target in a target group + - Used to register or deregister a target in a target group. author: "Rob White (@wimnat)" options: deregister_unused: description: - - The default behaviour for targets that are unused is to leave them registered. If instead you would like to remove them - set I(deregister_unused) to yes. + - The default behaviour for targets that are unused is to leave them registered. + - If instead you would like to remove them set I(deregister_unused=true). default: false type: bool target_az: description: - - An Availability Zone or all. This determines whether the target receives traffic from the load balancer nodes in the specified + - An Availability Zone or C(all). This determines whether the target receives traffic from the load balancer nodes in the specified Availability Zone or from all enabled Availability Zones for the load balancer. This parameter is not supported if the target type of the target group is instance. type: str target_group_arn: description: - - The Amazon Resource Name (ARN) of the target group. Mutually exclusive of I(target_group_name). + - The Amazon Resource Name (ARN) of the target group. + - Mutually exclusive of I(target_group_name). type: str target_group_name: description: - - The name of the target group. Mutually exclusive of I(target_group_arn). + - The name of the target group. + - Mutually exclusive of I(target_group_arn). type: str target_id: description: @@ -56,7 +58,7 @@ type: str target_status_timeout: description: - - Maximum time in seconds to wait for target_status change + - Maximum time in seconds to wait for I(target_status) change. required: false default: 60 type: int diff --git a/plugins/modules/iam_cert.py b/plugins/modules/iam_cert.py index 0fd8a6fe0d9..96c9bccae7c 100644 --- a/plugins/modules/iam_cert.py +++ b/plugins/modules/iam_cert.py @@ -33,17 +33,17 @@ type: str new_name: description: - - When state is present, this will update the name of the cert. - - The cert, key and cert_chain parameters will be ignored if this is defined. + - When I(state=present), this will update the name of the cert. + - The I(cert), I(key) and I(cert_chain) parameters will be ignored if this is defined. type: str new_path: description: - - When state is present, this will update the path of the cert. + - When I(state=present), this will update the path of the cert. - The I(cert), I(key) and I(cert_chain) parameters will be ignored if this is defined. type: str state: description: - - Whether to create(or update) or delete the certificate. + - Whether to create (or update) or delete the certificate. - If I(new_path) or I(new_name) is defined, specifying present will attempt to make an update these. required: true choices: [ "present", "absent" ] diff --git a/plugins/modules/route53.py b/plugins/modules/route53.py index 8b200aed02d..0a95c0afbb4 100644 --- a/plugins/modules/route53.py +++ b/plugins/modules/route53.py @@ -14,12 +14,12 @@ version_added: 1.0.0 short_description: add or delete entries in Amazons Route53 DNS service description: - - Creates and deletes DNS records in Amazons Route53 service + - Creates and deletes DNS records in Amazons Route53 service. options: state: description: - Specifies the state of the resource record. As of Ansible 2.4, the I(command) option has been changed - to I(state) as default and the choices 'present' and 'absent' have been added, but I(command) still works as well. + to I(state) as default and the choices C(present) and C(absent) have been added, but I(command) still works as well. required: true aliases: [ 'command' ] choices: [ 'present', 'absent', 'get', 'create', 'delete' ] @@ -76,14 +76,14 @@ type: bool retry_interval: description: - - In the case that route53 is still servicing a prior request, this module will wait and try again after this many seconds. - If you have many domain names, the default of 500 seconds may be too long. + - In the case that Route53 is still servicing a prior request, this module will wait and try again after this many seconds. + If you have many domain names, the default of C(500) seconds may be too long. default: 500 type: int private_zone: description: - - If set to C(yes), the private zone matching the requested name within the domain will be used if there are both public and private zones. - The default is to use the public zone. + - If set to C(true), the private zone matching the requested name within the domain will be used if there are both public and private zones. + - The default is to use the public zone. type: bool default: false identifier: @@ -122,7 +122,7 @@ type: str wait: description: - - Wait until the changes have been replicated to all Amazon Route 53 DNS servers. + - Wait until the changes have been replicated to all Amazon Route53 DNS servers. type: bool default: false wait_timeout: @@ -277,7 +277,7 @@ value: "0 0 22222 host1.foo.com,0 0 22222 host2.foo.com" # Note that TXT and SPF records must be surrounded -# by quotes when sent to Route 53: +# by quotes when sent to Route53: - name: Add a TXT record. community.aws.route53: state: present diff --git a/plugins/modules/sqs_queue.py b/plugins/modules/sqs_queue.py index 615c8c7aad7..5d65967974a 100644 --- a/plugins/modules/sqs_queue.py +++ b/plugins/modules/sqs_queue.py @@ -10,7 +10,7 @@ --- module: sqs_queue version_added: 1.0.0 -short_description: Creates or deletes AWS SQS queues. +short_description: Creates or deletes AWS SQS queues description: - Create or delete AWS SQS queues. - Update attributes on existing queues.