* Add U() in front of URL
* Add period at end of statement
* Spell check

Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
pull/46752/merge
Abhijeet Kasurde 6 years ago committed by Ryan Brown
parent 452a4ab781
commit d76a84a6c8

@ -23,10 +23,10 @@ extends_documentation_fragment:
- ec2 - ec2
options: options:
name: name:
description: Name of the Web Application Firewall condition to manage description: Name of the Web Application Firewall condition to manage.
required: yes required: yes
type: type:
description: the type of matching to perform description: the type of matching to perform.
choices: choices:
- byte - byte
- geo - geo
@ -37,25 +37,25 @@ options:
- xss - xss
filters: filters:
description: description:
- A list of the filters against which to match - A list of the filters against which to match.
- For I(type)=C(byte), valid keys are C(field_to_match), C(position), C(header), C(transformation) - For I(type)=C(byte), valid keys are C(field_to_match), C(position), C(header), C(transformation).
- For I(type)=C(geo), the only valid key is C(country) - For I(type)=C(geo), the only valid key is C(country).
- For I(type)=C(ip), the only valid key is C(ip_address) - For I(type)=C(ip), the only valid key is C(ip_address).
- For I(type)=C(regex), valid keys are C(field_to_match), C(transformation) and C(regex_pattern) - For I(type)=C(regex), valid keys are C(field_to_match), C(transformation) and C(regex_pattern).
- For I(type)=C(size), valid keys are C(field_to_match), C(transformation), C(comparison) and C(size) - For I(type)=C(size), valid keys are C(field_to_match), C(transformation), C(comparison) and C(size).
- For I(type)=C(sql), valid keys are C(field_to_match) and C(transformation) - For I(type)=C(sql), valid keys are C(field_to_match) and C(transformation).
- For I(type)=C(xss), valid keys are C(field_to_match) and C(transformation) - For I(type)=C(xss), valid keys are C(field_to_match) and C(transformation).
- I(field_to_match) can be one of C(uri), C(query_string), C(header) C(method) and C(body) - I(field_to_match) can be one of C(uri), C(query_string), C(header) C(method) and C(body).
- If I(field_to_match) is C(header), then C(header) must also be specified - If I(field_to_match) is C(header), then C(header) must also be specified.
- I(transformation) can be one of C(none), C(compress_white_space), C(html_entity_decode), C(lowercase), C(cmd_line), C(url_decode) - I(transformation) can be one of C(none), C(compress_white_space), C(html_entity_decode), C(lowercase), C(cmd_line), C(url_decode).
- I(position), can be one of C(exactly), C(starts_with), C(ends_with), C(contains), C(contains_word), - I(position), can be one of C(exactly), C(starts_with), C(ends_with), C(contains), C(contains_word).
- I(comparison) can be one of C(EQ), C(NE), C(LE), C(LT), C(GE), C(GT), - I(comparison) can be one of C(EQ), C(NE), C(LE), C(LT), C(GE), C(GT).
- I(target_string) is a maximum of 50 bytes - I(target_string) is a maximum of 50 bytes.
- I(regex_pattern) is a dict with a C(name) key and C(regex_strings) list of strings to match - I(regex_pattern) is a dict with a C(name) key and C(regex_strings) list of strings to match.
purge_filters: purge_filters:
description: Whether to remove existing filters from a condition if not passed in I(filters). Defaults to false description: Whether to remove existing filters from a condition if not passed in I(filters). Defaults to false.
state: state:
description: Whether the condition should be C(present) or C(absent) description: Whether the condition should be C(present) or C(absent).
choices: choices:
- present - present
- absent - absent

@ -61,7 +61,7 @@ options:
stack_policy: stack_policy:
description: description:
- the path of the cloudformation stack policy. A policy cannot be removed once placed, but it can be modified. - the path of the cloudformation stack policy. A policy cannot be removed once placed, but it can be modified.
(for instance, [allow all updates](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/protect-stack-resources.html#d0e9051) for instance, allow all updates U(https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/protect-stack-resources.html#d0e9051)
version_added: "1.9" version_added: "1.9"
tags: tags:
description: description:
@ -72,13 +72,13 @@ options:
- Location of file containing the template body. The URL must point to a template (max size 307,200 bytes) located in an S3 bucket in the same region - Location of file containing the template body. The URL must point to a template (max size 307,200 bytes) located in an S3 bucket in the same region
as the stack. as the stack.
- If 'state' is 'present' and the stack does not exist yet, either 'template', 'template_body' or 'template_url' - If 'state' is 'present' and the stack does not exist yet, either 'template', 'template_body' or 'template_url'
must be specified (but only one of them). If 'state' ispresent, the stack does exist, and neither 'template', must be specified (but only one of them). If 'state' is present, the stack does exist, and neither 'template',
'template_body' nor 'template_url' are specified, the previous template will be reused. 'template_body' nor 'template_url' are specified, the previous template will be reused.
version_added: "2.0" version_added: "2.0"
create_changeset: create_changeset:
description: description:
- "If stack already exists create a changeset instead of directly applying changes. - "If stack already exists create a changeset instead of directly applying changes.
See the AWS Change Sets docs U(http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html). See the AWS Change Sets docs U(https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html).
WARNING: if the stack does not exist, it will be created without changeset. If the state is absent, the stack will be deleted immediately with no WARNING: if the stack does not exist, it will be created without changeset. If the state is absent, the stack will be deleted immediately with no
changeset." changeset."
type: bool type: bool
@ -88,7 +88,7 @@ options:
description: description:
- Name given to the changeset when creating a changeset, only used when create_changeset is true. By default a name prefixed with Ansible-STACKNAME - Name given to the changeset when creating a changeset, only used when create_changeset is true. By default a name prefixed with Ansible-STACKNAME
is generated based on input parameters. is generated based on input parameters.
See the AWS Change Sets docs U(http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html) See the AWS Change Sets docs U(https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html)
version_added: "2.4" version_added: "2.4"
template_format: template_format:
description: description:
@ -100,7 +100,7 @@ options:
role_arn: role_arn:
description: description:
- The role that AWS CloudFormation assumes to create the stack. See the AWS CloudFormation Service Role - The role that AWS CloudFormation assumes to create the stack. See the AWS CloudFormation Service Role
docs U(http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-servicerole.html) docs U(https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-iam-servicerole.html)
version_added: "2.3" version_added: "2.3"
termination_protection: termination_protection:
description: description:
@ -110,7 +110,7 @@ options:
description: description:
- Template body. Use this to pass in the actual body of the Cloudformation template. - Template body. Use this to pass in the actual body of the Cloudformation template.
- If 'state' is 'present' and the stack does not exist yet, either 'template', 'template_body' or 'template_url' - If 'state' is 'present' and the stack does not exist yet, either 'template', 'template_body' or 'template_url'
must be specified (but only one of them). If 'state' ispresent, the stack does exist, and neither 'template', must be specified (but only one of them). If 'state' is present, the stack does exist, and neither 'template',
'template_body' nor 'template_url' are specified, the previous template will be reused. 'template_body' nor 'template_url' are specified, the previous template will be reused.
version_added: "2.5" version_added: "2.5"
events_limit: events_limit:

@ -47,8 +47,8 @@ options:
description: description:
- An existing S3 bucket where CloudTrail will deliver log files. - An existing S3 bucket where CloudTrail will deliver log files.
- This bucket should exist and have the proper policy. - This bucket should exist and have the proper policy.
- See U(http://docs.aws.amazon.com/awscloudtrail/latest/userguide/aggregating_logs_regions_bucket_policy.html) - See U(https://docs.aws.amazon.com/awscloudtrail/latest/userguide/aggregating_logs_regions_bucket_policy.html).
- Required when C(state=present) - Required when C(state=present).
version_added: "2.4" version_added: "2.4"
s3_key_prefix: s3_key_prefix:
description: description:
@ -71,25 +71,25 @@ options:
aliases: [ "include_global_service_events" ] aliases: [ "include_global_service_events" ]
sns_topic_name: sns_topic_name:
description: description:
- SNS Topic name to send notifications to when a log file is delivered - SNS Topic name to send notifications to when a log file is delivered.
version_added: "2.4" version_added: "2.4"
cloudwatch_logs_role_arn: cloudwatch_logs_role_arn:
description: description:
- Specifies a full ARN for an IAM role that assigns the proper permissions for CloudTrail to create and write to the log group. - Specifies a full ARN for an IAM role that assigns the proper permissions for CloudTrail to create and write to the log group.
- See U(https://docs.aws.amazon.com/awscloudtrail/latest/userguide/send-cloudtrail-events-to-cloudwatch-logs.html) - See U(https://docs.aws.amazon.com/awscloudtrail/latest/userguide/send-cloudtrail-events-to-cloudwatch-logs.html).
- Required when C(cloudwatch_logs_log_group_arn) - Required when C(cloudwatch_logs_log_group_arn).
version_added: "2.4" version_added: "2.4"
cloudwatch_logs_log_group_arn: cloudwatch_logs_log_group_arn:
description: description:
- A full ARN specifying a valid CloudWatch log group to which CloudTrail logs will be delivered. The log group should already exist. - A full ARN specifying a valid CloudWatch log group to which CloudTrail logs will be delivered. The log group should already exist.
- See U(https://docs.aws.amazon.com/awscloudtrail/latest/userguide/send-cloudtrail-events-to-cloudwatch-logs.html) - See U(https://docs.aws.amazon.com/awscloudtrail/latest/userguide/send-cloudtrail-events-to-cloudwatch-logs.html).
- Required when C(cloudwatch_logs_role_arn) - Required when C(cloudwatch_logs_role_arn).
version_added: "2.4" version_added: "2.4"
kms_key_id: kms_key_id:
description: description:
- Specifies the KMS key ID to use to encrypt the logs delivered by CloudTrail. This also has the effect of enabling log file encryption. - Specifies the KMS key ID to use to encrypt the logs delivered by CloudTrail. This also has the effect of enabling log file encryption.
- The value can be an alias name prefixed by "alias/", a fully specified ARN to an alias, a fully specified ARN to a key, or a globally unique identifier. - The value can be an alias name prefixed by "alias/", a fully specified ARN to an alias, a fully specified ARN to a key, or a globally unique identifier.
- See U(https://docs.aws.amazon.com/awscloudtrail/latest/userguide/encrypting-cloudtrail-log-files-with-aws-kms.html) - See U(https://docs.aws.amazon.com/awscloudtrail/latest/userguide/encrypting-cloudtrail-log-files-with-aws-kms.html).
version_added: "2.4" version_added: "2.4"
tags: tags:
description: description:

@ -27,7 +27,7 @@ description:
- Create and manage AWS Datapipelines. Creation is not idempotent in AWS, so the I(uniqueId) is created by hashing the options (minus objects) - Create and manage AWS Datapipelines. Creation is not idempotent in AWS, so the I(uniqueId) is created by hashing the options (minus objects)
given to the datapipeline. given to the datapipeline.
- The pipeline definition must be in the format given here - The pipeline definition must be in the format given here
U(http://docs.aws.amazon.com/datapipeline/latest/APIReference/API_PutPipelineDefinition.html#API_PutPipelineDefinition_RequestSyntax). U(https://docs.aws.amazon.com/datapipeline/latest/APIReference/API_PutPipelineDefinition.html#API_PutPipelineDefinition_RequestSyntax).
- Also operations will wait for a configurable amount of time to ensure the pipeline is in the requested state. - Also operations will wait for a configurable amount of time to ensure the pipeline is in the requested state.
options: options:
name: name:

@ -36,30 +36,30 @@ options:
description: description:
- identifier for this instance or set of instances, so that the module will be idempotent with respect to EC2 instances. - identifier for this instance or set of instances, so that the module will be idempotent with respect to EC2 instances.
This identifier is valid for at least 24 hours after the termination of the instance, and should not be reused for another call later on. This identifier is valid for at least 24 hours after the termination of the instance, and should not be reused for another call later on.
For details, see the description of client token at U(http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Run_Instance_Idempotency.html). For details, see the description of client token at U(https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Run_Instance_Idempotency.html).
group: group:
description: description:
- security group (or list of groups) to use with the instance - security group (or list of groups) to use with the instance.
aliases: [ 'groups' ] aliases: [ 'groups' ]
group_id: group_id:
version_added: "1.1" version_added: "1.1"
description: description:
- security group id (or list of ids) to use with the instance - security group id (or list of ids) to use with the instance.
region: region:
version_added: "1.2" version_added: "1.2"
description: description:
- The AWS region to use. Must be specified if ec2_url is not used. - The AWS region to use. Must be specified if ec2_url is not used.
If not specified then the value of the EC2_REGION environment variable, if any, is used. If not specified then the value of the EC2_REGION environment variable, if any, is used.
See U(http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region) See U(https://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region).
aliases: [ 'aws_region', 'ec2_region' ] aliases: [ 'aws_region', 'ec2_region' ]
zone: zone:
version_added: "1.2" version_added: "1.2"
description: description:
- AWS availability zone in which to launch the instance - AWS availability zone in which to launch the instance.
aliases: [ 'aws_zone', 'ec2_zone' ] aliases: [ 'aws_zone', 'ec2_zone' ]
instance_type: instance_type:
description: description:
- instance type to use for the instance, see U(http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html) - instance type to use for the instance, see U(https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html).
required: true required: true
tenancy: tenancy:
version_added: "1.9" version_added: "1.9"
@ -81,14 +81,14 @@ options:
choices: [ "one-time", "persistent" ] choices: [ "one-time", "persistent" ]
image: image:
description: description:
- I(ami) ID to use for the instance - I(ami) ID to use for the instance.
required: true required: true
kernel: kernel:
description: description:
- kernel I(eki) to use for the instance - kernel I(eki) to use for the instance.
ramdisk: ramdisk:
description: description:
- ramdisk I(eri) to use for the instance - ramdisk I(eri) to use for the instance.
wait: wait:
description: description:
- wait for the instance to reach its desired state before returning. Does not wait for SSH, see 'wait_for_connection' example for details. - wait for the instance to reach its desired state before returning. Does not wait for SSH, see 'wait_for_connection' example for details.
@ -96,52 +96,52 @@ options:
default: 'no' default: 'no'
wait_timeout: wait_timeout:
description: description:
- how long before wait gives up, in seconds - how long before wait gives up, in seconds.
default: 300 default: 300
spot_wait_timeout: spot_wait_timeout:
version_added: "1.5" version_added: "1.5"
description: description:
- how long to wait for the spot instance request to be fulfilled - how long to wait for the spot instance request to be fulfilled.
default: 600 default: 600
count: count:
description: description:
- number of instances to launch - number of instances to launch.
default: 1 default: 1
monitoring: monitoring:
version_added: "1.1" version_added: "1.1"
description: description:
- enable detailed monitoring (CloudWatch) for instance - enable detailed monitoring (CloudWatch) for instance.
type: bool type: bool
default: 'no' default: 'no'
user_data: user_data:
version_added: "0.9" version_added: "0.9"
description: description:
- opaque blob of data which is made available to the ec2 instance - opaque blob of data which is made available to the ec2 instance.
instance_tags: instance_tags:
version_added: "1.0" version_added: "1.0"
description: description:
- a hash/dictionary of tags to add to the new instance or for starting/stopping instance by tag; '{"key":"value"}' and '{"key":"value","key":"value"}' - a hash/dictionary of tags to add to the new instance or for starting/stopping instance by tag; '{"key":"value"}' and '{"key":"value","key":"value"}'.
placement_group: placement_group:
version_added: "1.3" version_added: "1.3"
description: description:
- placement group for the instance when using EC2 Clustered Compute - placement group for the instance when using EC2 Clustered Compute.
vpc_subnet_id: vpc_subnet_id:
version_added: "1.1" version_added: "1.1"
description: description:
- the subnet ID in which to launch the instance (VPC) - the subnet ID in which to launch the instance (VPC).
assign_public_ip: assign_public_ip:
version_added: "1.5" version_added: "1.5"
description: description:
- when provisioning within vpc, assign a public IP address. Boto library must be 2.13.0+ - when provisioning within vpc, assign a public IP address. Boto library must be 2.13.0+.
type: bool type: bool
private_ip: private_ip:
version_added: "1.2" version_added: "1.2"
description: description:
- the private ip address to assign the instance (from the vpc subnet) - the private ip address to assign the instance (from the vpc subnet).
instance_profile_name: instance_profile_name:
version_added: "1.3" version_added: "1.3"
description: description:
- Name of the IAM instance profile (i.e. what the EC2 console refers to as an "IAM Role") to use. Boto library must be 2.5.0+ - Name of the IAM instance profile (i.e. what the EC2 console refers to as an "IAM Role") to use. Boto library must be 2.5.0+.
instance_ids: instance_ids:
version_added: "1.3" version_added: "1.3"
description: description:
@ -156,13 +156,13 @@ options:
termination_protection: termination_protection:
version_added: "2.0" version_added: "2.0"
description: description:
- Enable or Disable the Termination Protection - Enable or Disable the Termination Protection.
type: bool type: bool
default: 'no' default: 'no'
instance_initiated_shutdown_behavior: instance_initiated_shutdown_behavior:
version_added: "2.2" version_added: "2.2"
description: description:
- Set whether AWS will Stop or Terminate an instance on shutdown. This parameter is ignored when using instance-store - Set whether AWS will Stop or Terminate an instance on shutdown. This parameter is ignored when using instance-store.
images (which require termination on shutdown). images (which require termination on shutdown).
default: 'stop' default: 'stop'
choices: [ "stop", "terminate" ] choices: [ "stop", "terminate" ]
@ -184,7 +184,7 @@ options:
ebs_optimized: ebs_optimized:
version_added: "1.6" version_added: "1.6"
description: description:
- whether instance is using optimized EBS volumes, see U(http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSOptimized.html) - whether instance is using optimized EBS volumes, see U(https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSOptimized.html).
default: 'no' default: 'no'
exact_count: exact_count:
version_added: "1.5" version_added: "1.5"
@ -207,7 +207,7 @@ options:
spot_launch_group: spot_launch_group:
version_added: "2.1" version_added: "2.1"
description: description:
- Launch group for spot request, see U(http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/how-spot-instances-work.html#spot-launch-group) - Launch group for spot request, see U(https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/how-spot-instances-work.html#spot-launch-group).
author: author:
- "Tim Gerla (@tgerla)" - "Tim Gerla (@tgerla)"
@ -858,7 +858,7 @@ def await_spot_requests(module, ec2, spot_requests, count):
# price, or group constraints in this case, we'll fail # price, or group constraints in this case, we'll fail
# the module if the reason for the state is anything # the module if the reason for the state is anything
# other than termination by user. Codes are documented at # other than termination by user. Codes are documented at
# http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-bid-status.html # https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-bid-status.html
if sir.status.code == 'instance-terminated-by-user': if sir.status.code == 'instance-terminated-by-user':
# do nothing, since the user likely did this on purpose # do nothing, since the user likely did this on purpose
pass pass

@ -19,7 +19,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. - A dict of filters to apply. Each dict item consists of a filter key and a filter value.
See U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeCustomerGateways.html) for possible filters. See U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeCustomerGateways.html) for possible filters.
customer_gateway_ids: customer_gateway_ids:
description: description:
- Get details of a specific customer gateways using customer gateway ID/IDs. This value should be provided as a list. - Get details of a specific customer gateways using customer gateway ID/IDs. This value should be provided as a list.

@ -31,7 +31,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. - A dict of filters to apply. Each dict item consists of a filter key and a filter value.
See U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeNetworkInterfaces.html) for possible filters. See U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeNetworkInterfaces.html) for possible filters.
extends_documentation_fragment: extends_documentation_fragment:
- aws - aws
- ec2 - ec2

@ -26,21 +26,21 @@ options:
- If you specify one or more instance IDs, only instances that have the specified IDs are returned. - If you specify one or more instance IDs, only instances that have the specified IDs are returned.
state: state:
description: description:
- Goal state for the instances - Goal state for the instances.
choices: [present, terminated, running, started, stopped, restarted, rebooted, absent] choices: [present, terminated, running, started, stopped, restarted, rebooted, absent]
default: present default: present
wait: wait:
description: description:
- Whether or not to wait for the desired state (use wait_timeout to customize this) - Whether or not to wait for the desired state (use wait_timeout to customize this).
default: true default: true
wait_timeout: wait_timeout:
description: description:
- How long to wait (in seconds) for the instance to finish booting/terminating - How long to wait (in seconds) for the instance to finish booting/terminating.
default: 600 default: 600
instance_type: instance_type:
description: description:
- Instance type to use for the instance, see U(http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html) - Instance type to use for the instance, see U(https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html)
Only required when instance is not already present Only required when instance is not already present.
default: t2.micro default: t2.micro
user_data: user_data:
description: description:
@ -57,7 +57,7 @@ options:
- IP address or DNS name of Tower server. Must be accessible via this address from the VPC that this instance will be launched in. - IP address or DNS name of Tower server. Must be accessible via this address from the VPC that this instance will be launched in.
job_template_id: job_template_id:
description: description:
- Either the integer ID of the Tower Job Template, or the name (name supported only for Tower 3.2+) - Either the integer ID of the Tower Job Template, or the name (name supported only for Tower 3.2+).
host_config_key: host_config_key:
description: description:
- Host configuration secret key generated by the Tower job template. - Host configuration secret key generated by the Tower job template.
@ -93,7 +93,7 @@ options:
vpc_subnet_id: vpc_subnet_id:
description: description:
- The subnet ID in which to launch the instance (VPC) - The subnet ID in which to launch the instance (VPC)
If none is provided, ec2_instance will chose the default zone of the default VPC If none is provided, ec2_instance will chose the default zone of the default VPC.
aliases: ['subnet_id'] aliases: ['subnet_id']
network: network:
description: description:
@ -110,12 +110,12 @@ options:
- A list of block device mappings, by default this will always use the AMI root device so the volumes option is primarily for adding more storage. - A list of block device mappings, by default this will always use the AMI root device so the volumes option is primarily for adding more storage.
- A mapping contains the (optional) keys device_name, virtual_name, ebs.volume_type, ebs.volume_size, ebs.kms_key_id, - A mapping contains the (optional) keys device_name, virtual_name, ebs.volume_type, ebs.volume_size, ebs.kms_key_id,
ebs.iops, and ebs.delete_on_termination. ebs.iops, and ebs.delete_on_termination.
- For more information about each parameter, see U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_BlockDeviceMapping.html) - For more information about each parameter, see U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_BlockDeviceMapping.html).
launch_template: launch_template:
description: description:
- The EC2 launch template to base instance configuration on. - The EC2 launch template to base instance configuration on.
- I(launch_template.id) the ID or the launch template (optional if name is specified) - I(launch_template.id) the ID or the launch template (optional if name is specified).
- I(launch_template.name) the pretty name of the launch template (optional if id is specified) - I(launch_template.name) the pretty name of the launch template (optional if id is specified).
- I(launch_template.version) the specific version of the launch template to use. If unspecified, the template default is chosen. - I(launch_template.version) the specific version of the launch template to use. If unspecified, the template default is chosen.
key_name: key_name:
description: description:
@ -151,7 +151,7 @@ options:
suboptions: suboptions:
threads_per_core: threads_per_core:
description: description:
- Select the number of threads per core to enable. Disable or Enable Intel HT - Select the number of threads per core to enable. Disable or Enable Intel HT.
choices: [1, 2] choices: [1, 2]
required: true required: true
core_count: core_count:
@ -163,12 +163,12 @@ options:
- Whether to allow detailed cloudwatch metrics to be collected, enabling more detailed alerting. - Whether to allow detailed cloudwatch metrics to be collected, enabling more detailed alerting.
ebs_optimized: ebs_optimized:
description: description:
- Whether instance is should use optimized EBS volumes, see U(http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSOptimized.html) - Whether instance is should use optimized EBS volumes, see U(https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSOptimized.html).
filters: filters:
description: description:
- A dict of filters to apply when deciding whether existing instances match and should be altered. Each dict item - A dict of filters to apply when deciding whether existing instances match and should be altered. Each dict item
consists of a filter key and a filter value. See consists of a filter key and a filter value. See
U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html) U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html).
for possible filters. Filter names and values are case sensitive. for possible filters. Filter names and values are case sensitive.
By default, instances are filtered for counting by their "Name" tag, base AMI, state (running, by default), and By default, instances are filtered for counting by their "Name" tag, base AMI, state (running, by default), and
subnet ID. Any queryable filter can be used. Good candidates are specific tags, SSH keys, or security groups. subnet ID. Any queryable filter can be used. Good candidates are specific tags, SSH keys, or security groups.

@ -30,7 +30,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. See - A dict of filters to apply. Each dict item consists of a filter key and a filter value. See
U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html) for possible filters. Filter U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html) for possible filters. Filter
names and values are case sensitive. names and values are case sensitive.
required: false required: false
default: {} default: {}

@ -22,7 +22,7 @@ author:
- Vinay Dandekar (@roadmapper) - Vinay Dandekar (@roadmapper)
description: description:
- This module fetches data from the instance metadata endpoint in ec2 as per - This module fetches data from the instance metadata endpoint in ec2 as per
http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html. U(https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html).
The module must be called from within the EC2 instance itself. The module must be called from within the EC2 instance itself.
notes: notes:
- Parameters to filter on ec2_metadata_facts may be added later. - Parameters to filter on ec2_metadata_facts may be added later.

@ -15,7 +15,7 @@ description:
- Create an EC2 Placement Group; if the placement group already exists, - Create an EC2 Placement Group; if the placement group already exists,
nothing is done. Or, delete an existing placement group. If the placement nothing is done. Or, delete an existing placement group. If the placement
group is absent, do nothing. See also group is absent, do nothing. See also
http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html U(https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/placement-groups.html)
version_added: "2.5" version_added: "2.5"
author: "Brad Macpherson (@iiibrad)" author: "Brad Macpherson (@iiibrad)"
options: options:

@ -41,7 +41,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. See \ - A dict of filters to apply. Each dict item consists of a filter key and a filter value. See \
U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSnapshots.html) for possible filters. Filter \ U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSnapshots.html) for possible filters. Filter \
names and values are case sensitive. names and values are case sensitive.
required: false required: false
default: {} default: {}

@ -368,7 +368,7 @@ def attach_volume(module, ec2, volume, instance):
changed = False changed = False
# If device_name isn't set, make a choice based on best practices here: # If device_name isn't set, make a choice based on best practices here:
# http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html # https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/block-device-mapping-concepts.html
# In future this needs to be more dynamic but combining block device mapping best practices # In future this needs to be more dynamic but combining block device mapping best practices
# (bounds for devices, as above) with instance.block_device_mapping data would be tricky. For me ;) # (bounds for devices, as above) with instance.block_device_mapping data would be tricky. For me ;)

@ -24,7 +24,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. - A dict of filters to apply. Each dict item consists of a filter key and a filter value.
See U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVolumes.html) for possible filters. See U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVolumes.html) for possible filters.
extends_documentation_fragment: extends_documentation_fragment:
- aws - aws
- ec2 - ec2

@ -49,7 +49,7 @@ options:
description: description:
- NetBIOS node type to advertise in the DHCP options. - NetBIOS node type to advertise in the DHCP options.
The AWS recommendation is to use 2 (when using netbios name services) The AWS recommendation is to use 2 (when using netbios name services)
http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_DHCP_Options.html U(https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_DHCP_Options.html)
vpc_id: vpc_id:
description: description:
- VPC ID to associate with the requested DHCP option set. - VPC ID to associate with the requested DHCP option set.

@ -24,7 +24,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. - A dict of filters to apply. Each dict item consists of a filter key and a filter value.
See U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeRouteTables.html) for possible filters. See U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeRouteTables.html) for possible filters.
dhcp_options_ids: dhcp_options_ids:
description: description:
- Get details of specific DHCP Option ID - Get details of specific DHCP Option ID

@ -32,7 +32,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. - A dict of filters to apply. Each dict item consists of a filter key and a filter value.
See U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVpcEndpoints.html) See U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVpcEndpoints.html)
for possible filters. for possible filters.
author: Karen Cheng (@Etherdaemon) author: Karen Cheng (@Etherdaemon)
extends_documentation_fragment: extends_documentation_fragment:

@ -24,7 +24,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. - A dict of filters to apply. Each dict item consists of a filter key and a filter value.
See U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInternetGateways.html) for possible filters. See U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInternetGateways.html) for possible filters.
internet_gateway_ids: internet_gateway_ids:
description: description:
- Get details of specific Internet Gateway ID. Provide this value as a list. - Get details of specific Internet Gateway ID. Provide this value as a list.

@ -16,7 +16,7 @@ module: ec2_vpc_nacl
short_description: create and delete Network ACLs. short_description: create and delete Network ACLs.
description: description:
- Read the AWS documentation for Network ACLS - Read the AWS documentation for Network ACLS
U(http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_ACLs.html) U(https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_ACLs.html)
version_added: "2.2" version_added: "2.2"
options: options:
name: name:

@ -29,7 +29,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. See \ - A dict of filters to apply. Each dict item consists of a filter key and a filter value. See \
U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeNetworkAcls.html) for possible filters. Filter \ U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeNetworkAcls.html) for possible filters. Filter \
names and values are case sensitive. names and values are case sensitive.
required: false required: false
default: {} default: {}

@ -25,7 +25,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. - A dict of filters to apply. Each dict item consists of a filter key and a filter value.
See U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeNatGateways.html) See U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeNatGateways.html)
for possible filters. for possible filters.
author: Karen Cheng (@Etherdaemon) author: Karen Cheng (@Etherdaemon)
extends_documentation_fragment: extends_documentation_fragment:

@ -37,7 +37,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. - A dict of filters to apply. Each dict item consists of a filter key and a filter value.
See U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVpcs.html) for possible filters. See U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVpcs.html) for possible filters.
extends_documentation_fragment: extends_documentation_fragment:
- aws - aws
- ec2 - ec2

@ -16,7 +16,7 @@ module: ec2_vpc_peer
short_description: create, delete, accept, and reject VPC peering connections between two VPCs. short_description: create, delete, accept, and reject VPC peering connections between two VPCs.
description: description:
- Read the AWS documentation for VPC Peering Connections - Read the AWS documentation for VPC Peering Connections
U(http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/vpc-peering.html) U(https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/vpc-peering.html).
version_added: "2.2" version_added: "2.2"
options: options:
vpc_id: vpc_id:

@ -24,7 +24,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. - A dict of filters to apply. Each dict item consists of a filter key and a filter value.
See U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVpcPeeringConnections.html) See U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVpcPeeringConnections.html)
for possible filters. for possible filters.
author: Karen Cheng (@Etherdaemon) author: Karen Cheng (@Etherdaemon)
extends_documentation_fragment: extends_documentation_fragment:

@ -23,7 +23,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. - A dict of filters to apply. Each dict item consists of a filter key and a filter value.
See U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeRouteTables.html) for possible filters. See U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeRouteTables.html) for possible filters.
extends_documentation_fragment: extends_documentation_fragment:
- aws - aws
- ec2 - ec2

@ -38,7 +38,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. - A dict of filters to apply. Each dict item consists of a filter key and a filter value.
See U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSubnets.html) for possible filters. See U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSubnets.html) for possible filters.
extends_documentation_fragment: extends_documentation_fragment:
- aws - aws
- ec2 - ec2

@ -23,7 +23,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. - A dict of filters to apply. Each dict item consists of a filter key and a filter value.
See U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeRouteTables.html) for possible filters. See U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeRouteTables.html) for possible filters.
vpn_gateway_ids: vpn_gateway_ids:
description: description:
- Get details of a specific Virtual Gateway ID. This value should be provided as a list. - Get details of a specific Virtual Gateway ID. This value should be provided as a list.

@ -21,7 +21,7 @@ options:
filters: filters:
description: description:
- A dict of filters to apply. Each dict item consists of a filter key and a filter value. - A dict of filters to apply. Each dict item consists of a filter key and a filter value.
See U(http://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVpnConnections.html) for possible filters. See U(https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVpnConnections.html) for possible filters.
required: false required: false
vpn_connection_ids: vpn_connection_ids:
description: description:

@ -274,7 +274,7 @@ class EFSConnection(object):
AWS updated it and now there is no need to add a suffix. MountPoint is left for back-compatibility purpose AWS updated it and now there is no need to add a suffix. MountPoint is left for back-compatibility purpose
And new FilesystemAddress variable is introduced for direct use with other modules (e.g. mount) And new FilesystemAddress variable is introduced for direct use with other modules (e.g. mount)
AWS documentation is available here: AWS documentation is available here:
http://docs.aws.amazon.com/efs/latest/ug/gs-step-three-connect-to-ec2-instance.html https://docs.aws.amazon.com/efs/latest/ug/gs-step-three-connect-to-ec2-instance.html
""" """
item['MountPoint'] = '.%s.efs.%s.amazonaws.com:/' % (item['FileSystemId'], self.region) item['MountPoint'] = '.%s.efs.%s.amazonaws.com:/' % (item['FileSystemId'], self.region)
item['FilesystemAddress'] = '%s.efs.%s.amazonaws.com:/' % (item['FileSystemId'], self.region) item['FilesystemAddress'] = '%s.efs.%s.amazonaws.com:/' % (item['FileSystemId'], self.region)

@ -270,7 +270,7 @@ class EFSConnection(object):
AWS updated it and now there is no need to add a suffix. MountPoint is left for back-compatibility purpose AWS updated it and now there is no need to add a suffix. MountPoint is left for back-compatibility purpose
And new FilesystemAddress variable is introduced for direct use with other modules (e.g. mount) And new FilesystemAddress variable is introduced for direct use with other modules (e.g. mount)
AWS documentation is available here: AWS documentation is available here:
http://docs.aws.amazon.com/efs/latest/ug/gs-step-three-connect-to-ec2-instance.html U(https://docs.aws.amazon.com/efs/latest/ug/gs-step-three-connect-to-ec2-instance.html)
""" """
item['MountPoint'] = '.%s.efs.%s.amazonaws.com:/' % (item['FileSystemId'], self.region) item['MountPoint'] = '.%s.efs.%s.amazonaws.com:/' % (item['FileSystemId'], self.region)
item['FilesystemAddress'] = '%s.efs.%s.amazonaws.com:/' % (item['FileSystemId'], self.region) item['FilesystemAddress'] = '%s.efs.%s.amazonaws.com:/' % (item['FileSystemId'], self.region)

@ -44,7 +44,7 @@ options:
target_status: target_status:
description: description:
- Blocks and waits for the target status to equal given value. For more detail on target status see - Blocks and waits for the target status to equal given value. For more detail on target status see
U(http://docs.aws.amazon.com/elasticloadbalancing/latest/application/target-group-health-checks.html#target-health-states) U(https://docs.aws.amazon.com/elasticloadbalancing/latest/application/target-group-health-checks.html#target-health-states)
required: false required: false
choices: [ 'initial', 'healthy', 'unhealthy', 'unused', 'draining', 'unavailable' ] choices: [ 'initial', 'healthy', 'unhealthy', 'unused', 'draining', 'unavailable' ]
target_status_timeout: target_status_timeout:

@ -16,8 +16,8 @@ module: elb_target_group
short_description: Manage a target group for an Application or Network load balancer short_description: Manage a target group for an Application or Network load balancer
description: description:
- Manage an AWS Elastic Load Balancer target group. See - Manage an AWS Elastic Load Balancer target group. See
U(http://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html) or U(https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html) or
U(http://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-target-groups.html) for details. U(https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-target-groups.html) for details.
version_added: "2.4" version_added: "2.4"
requirements: [ boto3 ] requirements: [ boto3 ]
author: "Rob White (@wimnat)" author: "Rob White (@wimnat)"

@ -74,7 +74,7 @@ options:
description: description:
- Which version/alias of the function to run. This defaults to the - Which version/alias of the function to run. This defaults to the
C(LATEST) revision, but can be set to any existing version or alias. C(LATEST) revision, but can be set to any existing version or alias.
See https;//docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html See U(https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html)
for details. for details.
default: LATEST default: LATEST
payload: payload:

@ -48,11 +48,11 @@ mfa_devices:
EXAMPLES = ''' EXAMPLES = '''
# Note: These examples do not set authentication details, see the AWS Guide for details. # Note: These examples do not set authentication details, see the AWS Guide for details.
# List MFA devices (more details: http://docs.aws.amazon.com/IAM/latest/APIReference/API_ListMFADevices.html) # List MFA devices (more details: https://docs.aws.amazon.com/IAM/latest/APIReference/API_ListMFADevices.html)
- iam_mfa_device_facts: - iam_mfa_device_facts:
register: mfa_devices register: mfa_devices
# Assume an existing role (more details: http://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) # Assume an existing role (more details: https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)
- sts_assume_role: - sts_assume_role:
mfa_serial_number: "{{ mfa_devices.mfa_devices[0].serial_number }}" mfa_serial_number: "{{ mfa_devices.mfa_devices[0].serial_number }}"
role_arn: "arn:aws:iam::123456789012:role/someRole" role_arn: "arn:aws:iam::123456789012:role/someRole"

@ -17,7 +17,7 @@ author: "Rob White (@wimnat)"
options: options:
path: path:
description: description:
- The path to the role. For more information about paths, see U(http://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html). - The path to the role. For more information about paths, see U(https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html).
default: "/" default: "/"
name: name:
description: description:

@ -25,7 +25,7 @@ options:
role_arn: role_arn:
description: description:
- The Amazon Resource Name (ARN) of the role that the caller is - The Amazon Resource Name (ARN) of the role that the caller is
assuming (http://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html#Identifiers_ARNs) assuming U(https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html#Identifiers_ARNs).
required: true required: true
role_session_name: role_session_name:
description: description:
@ -37,8 +37,8 @@ options:
duration_seconds: duration_seconds:
description: description:
- The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) to 43200 seconds (12 hours). - The duration, in seconds, of the role session. The value can range from 900 seconds (15 minutes) to 43200 seconds (12 hours).
The max dependis on the IAM role's sessions duration setting. The max depends on the IAM role's sessions duration setting.
By default, the value is set to 3600 seconds.s By default, the value is set to 3600 seconds.
external_id: external_id:
description: description:
- A unique identifier that is used by third parties to assume a role in their customers' accounts. - A unique identifier that is used by third parties to assume a role in their customers' accounts.
@ -49,7 +49,7 @@ options:
description: description:
- The value provided by the MFA device, if the trust policy of the role being assumed requires MFA. - The value provided by the MFA device, if the trust policy of the role being assumed requires MFA.
notes: notes:
- In order to use the assumed role in a following playbook task you must pass the access_key, access_secret and access_token - In order to use the assumed role in a following playbook task you must pass the access_key, access_secret and access_token.
extends_documentation_fragment: extends_documentation_fragment:
- aws - aws
- ec2 - ec2
@ -85,7 +85,7 @@ changed:
EXAMPLES = ''' EXAMPLES = '''
# Note: These examples do not set authentication details, see the AWS Guide for details. # Note: These examples do not set authentication details, see the AWS Guide for details.
# Assume an existing role (more details: http://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html) # Assume an existing role (more details: https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)
sts_assume_role: sts_assume_role:
role_arn: "arn:aws:iam::123456789012:role/someRole" role_arn: "arn:aws:iam::123456789012:role/someRole"
role_session_name: "someRoleSession" role_session_name: "someRoleSession"

@ -23,7 +23,7 @@ options:
duration_seconds: duration_seconds:
description: description:
- The duration, in seconds, of the session token. - The duration, in seconds, of the session token.
See http://docs.aws.amazon.com/STS/latest/APIReference/API_GetSessionToken.html#API_GetSessionToken_RequestParameters See U(https://docs.aws.amazon.com/STS/latest/APIReference/API_GetSessionToken.html#API_GetSessionToken_RequestParameters)
for acceptable and default values. for acceptable and default values.
mfa_serial_number: mfa_serial_number:
description: description:
@ -62,7 +62,7 @@ changed:
EXAMPLES = ''' EXAMPLES = '''
# Note: These examples do not set authentication details, see the AWS Guide for details. # Note: These examples do not set authentication details, see the AWS Guide for details.
# Get a session token (more details: http://docs.aws.amazon.com/STS/latest/APIReference/API_GetSessionToken.html) # Get a session token (more details: https://docs.aws.amazon.com/STS/latest/APIReference/API_GetSessionToken.html)
sts_session_token: sts_session_token:
duration_seconds: 3600 duration_seconds: 3600
register: session_credentials register: session_credentials

Loading…
Cancel
Save