diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 6f8c5ebd1d3..e96d6d52b72 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -5,6 +5,24 @@ community.aws Release Notes .. contents:: Topics +v2.2.0 +====== + +Minor Changes +------------- + +- ec2_instance - add count parameter support (https://github.com/ansible-collections/amazon.aws/pull/539). + +Bugfixes +-------- + +- aws_ec2 inventory - use the iam_role_arn configuration parameter to assume the role before trying to call DescribeRegions if the regions configuration is not set and AWS credentials provided without enough privilege to perform the DescribeRegions action. (https://github.com/ansible-collections/amazon.aws/issues/566). +- ec2_vol - Sets the Iops value in req_obj even if the iops value has not changed, to allow modifying volume types that require passing an iops value to boto. (https://github.com/ansible-collections/amazon.aws/pull/606) +- ec2_vol - changing a volume from a type that does not support IOPS (like ``standard``) to a type that does (like ``gp3``) fails (https://github.com/ansible-collections/amazon.aws/issues/626). +- ec2_vpc_igw - fix 'NoneType' object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/691). +- ec2_vpc_igw - use paginator for describe internet gateways and add retry to fix NoneType object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/695). +- elb_classic_lb - handle security_group_ids when providing security_group_names and fix broken tasks in integration test (https://github.com/ansible-collections/amazon.aws/pull/592). + v2.1.0 ====== diff --git a/README.md b/README.md index 42040d9e1e6..ffbc1775c45 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,8 @@ AWS related modules and plugins supported by the Ansible community are in the [c This collection has been tested against following Ansible versions: **>=2.9.10**. +For collections that support Ansible 2.9, please ensure you update your `network_os` to use the +fully qualified collection name (for example, `cisco.ios.ios`). Plugins and modules within a collection may be tested with only specific Ansible versions. A collection may contain metadata that identifies these versions. PEP440 is the schema used to describe the versions of Ansible. @@ -27,61 +29,61 @@ Version 2.0.0 of this collection supports `boto3 >= 1.15.0` and `botocore >= 1.1 ### Inventory plugins Name | Description --- | --- -[amazon.aws.aws_ec2](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.aws_ec2_inventory.rst)|EC2 inventory source -[amazon.aws.aws_rds](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.aws_rds_inventory.rst)|rds instance source +[amazon.aws.aws_ec2](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.aws_ec2_inventory.rst)|EC2 inventory source +[amazon.aws.aws_rds](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.aws_rds_inventory.rst)|rds instance source ### Lookup plugins Name | Description --- | --- -[amazon.aws.aws_account_attribute](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.aws_account_attribute_lookup.rst)|Look up AWS account attributes. -[amazon.aws.aws_secret](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.aws_secret_lookup.rst)|Look up secrets stored in AWS Secrets Manager. -[amazon.aws.aws_service_ip_ranges](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.aws_service_ip_ranges_lookup.rst)|Look up the IP ranges for services provided in AWS such as EC2 and S3. -[amazon.aws.aws_ssm](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.aws_ssm_lookup.rst)|Get the value for a SSM parameter or all parameters under a path. +[amazon.aws.aws_account_attribute](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.aws_account_attribute_lookup.rst)|Look up AWS account attributes. +[amazon.aws.aws_secret](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.aws_secret_lookup.rst)|Look up secrets stored in AWS Secrets Manager. +[amazon.aws.aws_service_ip_ranges](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.aws_service_ip_ranges_lookup.rst)|Look up the IP ranges for services provided in AWS such as EC2 and S3. +[amazon.aws.aws_ssm](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.aws_ssm_lookup.rst)|Get the value for a SSM parameter or all parameters under a path. ### Modules Name | Description --- | --- -[amazon.aws.aws_az_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.aws_az_info_module.rst)|Gather information about availability zones in AWS. -[amazon.aws.aws_caller_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.aws_caller_info_module.rst)|Get information about the user and account being used to make AWS calls. -[amazon.aws.aws_s3](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.aws_s3_module.rst)|manage objects in S3. -[amazon.aws.cloudformation](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.cloudformation_module.rst)|Create or delete an AWS CloudFormation stack -[amazon.aws.cloudformation_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.cloudformation_info_module.rst)|Obtain information about an AWS CloudFormation stack -[amazon.aws.ec2](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_module.rst)|create, terminate, start or stop an instance in ec2 -[amazon.aws.ec2_ami](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_ami_module.rst)|Create or destroy an image (AMI) in ec2 -[amazon.aws.ec2_ami_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_ami_info_module.rst)|Gather information about ec2 AMIs -[amazon.aws.ec2_eni](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_eni_module.rst)|Create and optionally attach an Elastic Network Interface (ENI) to an instance -[amazon.aws.ec2_eni_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_eni_info_module.rst)|Gather information about ec2 ENI interfaces in AWS -[amazon.aws.ec2_group](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_group_module.rst)|maintain an ec2 VPC security group. -[amazon.aws.ec2_group_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_group_info_module.rst)|Gather information about ec2 security groups in AWS. -[amazon.aws.ec2_instance](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_instance_module.rst)|Create & manage EC2 instances -[amazon.aws.ec2_instance_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_instance_info_module.rst)|Gather information about ec2 instances in AWS -[amazon.aws.ec2_key](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_key_module.rst)|create or delete an ec2 key pair -[amazon.aws.ec2_metadata_facts](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_metadata_facts_module.rst)|gathers facts (instance metadata) about remote hosts within EC2 -[amazon.aws.ec2_snapshot](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_snapshot_module.rst)|Creates a snapshot from an existing volume -[amazon.aws.ec2_snapshot_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_snapshot_info_module.rst)|Gather information about ec2 volume snapshots in AWS -[amazon.aws.ec2_spot_instance](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_spot_instance_module.rst)|request, stop, reboot or cancel spot instance -[amazon.aws.ec2_spot_instance_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_spot_instance_info_module.rst)|Gather information about ec2 spot instance requests -[amazon.aws.ec2_tag](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_tag_module.rst)|create and remove tags on ec2 resources -[amazon.aws.ec2_tag_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_tag_info_module.rst)|list tags on ec2 resources -[amazon.aws.ec2_vol](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vol_module.rst)|Create and attach a volume, return volume id and device map -[amazon.aws.ec2_vol_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vol_info_module.rst)|Gather information about ec2 volumes in AWS -[amazon.aws.ec2_vpc_dhcp_option](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_dhcp_option_module.rst)|Manages DHCP Options, and can ensure the DHCP options for the given VPC match what's requested -[amazon.aws.ec2_vpc_dhcp_option_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_dhcp_option_info_module.rst)|Gather information about dhcp options sets in AWS -[amazon.aws.ec2_vpc_endpoint](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_endpoint_module.rst)|Create and delete AWS VPC Endpoints. -[amazon.aws.ec2_vpc_endpoint_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_endpoint_info_module.rst)|Retrieves AWS VPC endpoints details using AWS methods. -[amazon.aws.ec2_vpc_endpoint_service_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_endpoint_service_info_module.rst)|retrieves AWS VPC endpoint service details -[amazon.aws.ec2_vpc_igw](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_igw_module.rst)|Manage an AWS VPC Internet gateway -[amazon.aws.ec2_vpc_igw_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_igw_info_module.rst)|Gather information about internet gateways in AWS -[amazon.aws.ec2_vpc_nat_gateway](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_nat_gateway_module.rst)|Manage AWS VPC NAT Gateways. -[amazon.aws.ec2_vpc_nat_gateway_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_nat_gateway_info_module.rst)|Retrieves AWS VPC Managed Nat Gateway details using AWS methods. -[amazon.aws.ec2_vpc_net](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_net_module.rst)|Configure AWS virtual private clouds -[amazon.aws.ec2_vpc_net_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_net_info_module.rst)|Gather information about ec2 VPCs in AWS -[amazon.aws.ec2_vpc_route_table](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_route_table_module.rst)|Manage route tables for AWS virtual private clouds -[amazon.aws.ec2_vpc_route_table_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_route_table_info_module.rst)|Gather information about ec2 VPC route tables in AWS -[amazon.aws.ec2_vpc_subnet](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_subnet_module.rst)|Manage subnets in AWS virtual private clouds -[amazon.aws.ec2_vpc_subnet_info](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.ec2_vpc_subnet_info_module.rst)|Gather information about ec2 VPC subnets in AWS -[amazon.aws.elb_classic_lb](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.elb_classic_lb_module.rst)|creates, updates or destroys an Amazon ELB. -[amazon.aws.s3_bucket](https://github.com/ansible-collections/amazon.aws/blob/main/docs/amazon.aws.s3_bucket_module.rst)|Manage S3 buckets in AWS, DigitalOcean, Ceph, Walrus, FakeS3 and StorageGRID +[amazon.aws.aws_az_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.aws_az_info_module.rst)|Gather information about availability zones in AWS. +[amazon.aws.aws_caller_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.aws_caller_info_module.rst)|Get information about the user and account being used to make AWS calls. +[amazon.aws.aws_s3](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.aws_s3_module.rst)|manage objects in S3. +[amazon.aws.cloudformation](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.cloudformation_module.rst)|Create or delete an AWS CloudFormation stack +[amazon.aws.cloudformation_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.cloudformation_info_module.rst)|Obtain information about an AWS CloudFormation stack +[amazon.aws.ec2](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_module.rst)|create, terminate, start or stop an instance in ec2 +[amazon.aws.ec2_ami](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_ami_module.rst)|Create or destroy an image (AMI) in ec2 +[amazon.aws.ec2_ami_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_ami_info_module.rst)|Gather information about ec2 AMIs +[amazon.aws.ec2_eni](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_eni_module.rst)|Create and optionally attach an Elastic Network Interface (ENI) to an instance +[amazon.aws.ec2_eni_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_eni_info_module.rst)|Gather information about ec2 ENI interfaces in AWS +[amazon.aws.ec2_group](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_group_module.rst)|maintain an ec2 VPC security group. +[amazon.aws.ec2_group_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_group_info_module.rst)|Gather information about ec2 security groups in AWS. +[amazon.aws.ec2_instance](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_instance_module.rst)|Create & manage EC2 instances +[amazon.aws.ec2_instance_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_instance_info_module.rst)|Gather information about ec2 instances in AWS +[amazon.aws.ec2_key](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_key_module.rst)|create or delete an ec2 key pair +[amazon.aws.ec2_metadata_facts](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_metadata_facts_module.rst)|gathers facts (instance metadata) about remote hosts within EC2 +[amazon.aws.ec2_snapshot](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_snapshot_module.rst)|Creates a snapshot from an existing volume +[amazon.aws.ec2_snapshot_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_snapshot_info_module.rst)|Gather information about ec2 volume snapshots in AWS +[amazon.aws.ec2_spot_instance](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_spot_instance_module.rst)|request, stop, reboot or cancel spot instance +[amazon.aws.ec2_spot_instance_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_spot_instance_info_module.rst)|Gather information about ec2 spot instance requests +[amazon.aws.ec2_tag](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_tag_module.rst)|create and remove tags on ec2 resources +[amazon.aws.ec2_tag_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_tag_info_module.rst)|list tags on ec2 resources +[amazon.aws.ec2_vol](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vol_module.rst)|Create and attach a volume, return volume id and device map +[amazon.aws.ec2_vol_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vol_info_module.rst)|Gather information about ec2 volumes in AWS +[amazon.aws.ec2_vpc_dhcp_option](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_dhcp_option_module.rst)|Manages DHCP Options, and can ensure the DHCP options for the given VPC match what's requested +[amazon.aws.ec2_vpc_dhcp_option_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_dhcp_option_info_module.rst)|Gather information about dhcp options sets in AWS +[amazon.aws.ec2_vpc_endpoint](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_endpoint_module.rst)|Create and delete AWS VPC Endpoints. +[amazon.aws.ec2_vpc_endpoint_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_endpoint_info_module.rst)|Retrieves AWS VPC endpoints details using AWS methods. +[amazon.aws.ec2_vpc_endpoint_service_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_endpoint_service_info_module.rst)|retrieves AWS VPC endpoint service details +[amazon.aws.ec2_vpc_igw](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_igw_module.rst)|Manage an AWS VPC Internet gateway +[amazon.aws.ec2_vpc_igw_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_igw_info_module.rst)|Gather information about internet gateways in AWS +[amazon.aws.ec2_vpc_nat_gateway](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_nat_gateway_module.rst)|Manage AWS VPC NAT Gateways. +[amazon.aws.ec2_vpc_nat_gateway_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_nat_gateway_info_module.rst)|Retrieves AWS VPC Managed Nat Gateway details using AWS methods. +[amazon.aws.ec2_vpc_net](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_net_module.rst)|Configure AWS virtual private clouds +[amazon.aws.ec2_vpc_net_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_net_info_module.rst)|Gather information about ec2 VPCs in AWS +[amazon.aws.ec2_vpc_route_table](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_route_table_module.rst)|Manage route tables for AWS virtual private clouds +[amazon.aws.ec2_vpc_route_table_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_route_table_info_module.rst)|Gather information about ec2 VPC route tables in AWS +[amazon.aws.ec2_vpc_subnet](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_subnet_module.rst)|Manage subnets in AWS virtual private clouds +[amazon.aws.ec2_vpc_subnet_info](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.ec2_vpc_subnet_info_module.rst)|Gather information about ec2 VPC subnets in AWS +[amazon.aws.elb_classic_lb](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.elb_classic_lb_module.rst)|creates, updates or destroys an Amazon ELB. +[amazon.aws.s3_bucket](https://github.com/ansible-collections/amazon.aws/blob/stable-2/docs/amazon.aws.s3_bucket_module.rst)|Manage S3 buckets in AWS, DigitalOcean, Ceph, Walrus, FakeS3 and StorageGRID diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml index 61572a6fef7..0a78be6268f 100644 --- a/changelogs/changelog.yaml +++ b/changelogs/changelog.yaml @@ -594,3 +594,31 @@ releases: - 552-elb_classic_lb-fact.yml - 557-action_group-missing-entry.yml release_date: '2021-11-11' + 2.2.0: + changes: + bugfixes: + - aws_ec2 inventory - use the iam_role_arn configuration parameter to assume + the role before trying to call DescribeRegions if the regions configuration + is not set and AWS credentials provided without enough privilege to perform + the DescribeRegions action. (https://github.com/ansible-collections/amazon.aws/issues/566). + - ec2_vol - Sets the Iops value in req_obj even if the iops value has not changed, + to allow modifying volume types that require passing an iops value to boto. + (https://github.com/ansible-collections/amazon.aws/pull/606) + - ec2_vol - changing a volume from a type that does not support IOPS (like ``standard``) + to a type that does (like ``gp3``) fails (https://github.com/ansible-collections/amazon.aws/issues/626). + - ec2_vpc_igw - fix 'NoneType' object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/691). + - ec2_vpc_igw - use paginator for describe internet gateways and add retry to + fix NoneType object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/695). + - elb_classic_lb - handle security_group_ids when providing security_group_names + and fix broken tasks in integration test (https://github.com/ansible-collections/amazon.aws/pull/592). + minor_changes: + - ec2_instance - add count parameter support (https://github.com/ansible-collections/amazon.aws/pull/539). + fragments: + - 539-ec2_instance_add_count_param.yml + - 592-elb_classic_lb-handle-sg-ids-fix-tests.yml + - 606-ec2_vol-set-iops-even-if-unchanged-for-boto-req.yml + - 619-inventory-aws_ec2-assume-arn-role-when-listing-regions.yml + - 626-ec2_vol-iops-when-source-does-not-have-iops.yml + - 691-ec2_vpc_igw-fix-null-igw-error.yml + - 695-ec2_vpc_igw-fix-nonetype-with-paginator.yml + release_date: '2022-03-22' diff --git a/changelogs/fragments/539-ec2_instance_add_count_param.yml b/changelogs/fragments/539-ec2_instance_add_count_param.yml deleted file mode 100644 index 2d5790c3d3a..00000000000 --- a/changelogs/fragments/539-ec2_instance_add_count_param.yml +++ /dev/null @@ -1,3 +0,0 @@ -minor_changes: - - ec2_instance - add count parameter support - (https://github.com/ansible-collections/amazon.aws/pull/539). diff --git a/changelogs/fragments/592-elb_classic_lb-handle-sg-ids-fix-tests.yml b/changelogs/fragments/592-elb_classic_lb-handle-sg-ids-fix-tests.yml deleted file mode 100644 index 55229b1e6e3..00000000000 --- a/changelogs/fragments/592-elb_classic_lb-handle-sg-ids-fix-tests.yml +++ /dev/null @@ -1,2 +0,0 @@ -bugfixes: -- elb_classic_lb - handle security_group_ids when providing security_group_names and fix broken tasks in integration test (https://github.com/ansible-collections/amazon.aws/pull/592). diff --git a/changelogs/fragments/606-ec2_vol-set-iops-even-if-unchanged-for-boto-req.yml b/changelogs/fragments/606-ec2_vol-set-iops-even-if-unchanged-for-boto-req.yml deleted file mode 100644 index c3c1580d463..00000000000 --- a/changelogs/fragments/606-ec2_vol-set-iops-even-if-unchanged-for-boto-req.yml +++ /dev/null @@ -1,5 +0,0 @@ -bugfixes: -- >- - ec2_vol - Sets the Iops value in req_obj even if the iops value - has not changed, to allow modifying volume types that require - passing an iops value to boto. (https://github.com/ansible-collections/amazon.aws/pull/606) diff --git a/changelogs/fragments/619-inventory-aws_ec2-assume-arn-role-when-listing-regions.yml b/changelogs/fragments/619-inventory-aws_ec2-assume-arn-role-when-listing-regions.yml deleted file mode 100644 index 0d055c6f525..00000000000 --- a/changelogs/fragments/619-inventory-aws_ec2-assume-arn-role-when-listing-regions.yml +++ /dev/null @@ -1,5 +0,0 @@ -bugfixes: -- >- - aws_ec2 inventory - use the iam_role_arn configuration parameter to assume the role before trying to call DescribeRegions - if the regions configuration is not set and AWS credentials provided without enough privilege to perform the DescribeRegions action. - (https://github.com/ansible-collections/amazon.aws/issues/566). diff --git a/changelogs/fragments/626-ec2_vol-iops-when-source-does-not-have-iops.yml b/changelogs/fragments/626-ec2_vol-iops-when-source-does-not-have-iops.yml deleted file mode 100644 index 6c518b6b932..00000000000 --- a/changelogs/fragments/626-ec2_vol-iops-when-source-does-not-have-iops.yml +++ /dev/null @@ -1,3 +0,0 @@ ---- -bugfixes: - - ec2_vol - changing a volume from a type that does not support IOPS (like ``standard``) to a type that does (like ``gp3``) fails (https://github.com/ansible-collections/amazon.aws/issues/626). diff --git a/changelogs/fragments/691-ec2_vpc_igw-fix-null-igw-error.yml b/changelogs/fragments/691-ec2_vpc_igw-fix-null-igw-error.yml deleted file mode 100644 index eaede040773..00000000000 --- a/changelogs/fragments/691-ec2_vpc_igw-fix-null-igw-error.yml +++ /dev/null @@ -1,2 +0,0 @@ -bugfixes: - - ec2_vpc_igw - fix 'NoneType' object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/691). \ No newline at end of file diff --git a/changelogs/fragments/695-ec2_vpc_igw-fix-nonetype-with-paginator.yml b/changelogs/fragments/695-ec2_vpc_igw-fix-nonetype-with-paginator.yml deleted file mode 100644 index ff20ab02825..00000000000 --- a/changelogs/fragments/695-ec2_vpc_igw-fix-nonetype-with-paginator.yml +++ /dev/null @@ -1,2 +0,0 @@ -bugfixes: - - ec2_vpc_igw - use paginator for describe internet gateways and add retry to fix NoneType object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/695). diff --git a/docs/amazon.aws.aws_ec2_inventory.rst b/docs/amazon.aws.aws_ec2_inventory.rst index bc43532ea5f..cc6f0bdf003 100644 --- a/docs/amazon.aws.aws_ec2_inventory.rst +++ b/docs/amazon.aws.aws_ec2_inventory.rst @@ -17,7 +17,7 @@ amazon.aws.aws_ec2 Synopsis -------- - Get inventory hosts from Amazon Web Services EC2. -- Uses a YAML configuration file that ends with ``aws_ec2.(yml|yaml``). +- Uses a YAML configuration file that ends with ``aws_ec2.{yml|yaml}``. diff --git a/docs/amazon.aws.ec2_instance_module.rst b/docs/amazon.aws.ec2_instance_module.rst index 95fba6ddaf8..5ac085c1467 100644 --- a/docs/amazon.aws.ec2_instance_module.rst +++ b/docs/amazon.aws.ec2_instance_module.rst @@ -129,6 +129,24 @@ Parameters

aliases: ec2_secret_key, secret_key
+ + +
+ count + +
+ integer +
+
added in 2.2.0
+ + + + +
Number of instances to launch.
+
Setting this value will result in always launching new instances.
+
Mutually exclusive with exact_count.
+ +
@@ -278,6 +296,25 @@ Parameters

aliases: aws_endpoint_url, endpoint_url
+ + +
+ exact_count + +
+ integer +
+
added in 2.2.0
+ + + + +
An integer value which indicates how many instances that match the filters parameter should be running.
+
Instances are either created or terminated based on this value.
+
If termination takes place, least recently created instances will be terminated based on Launch Time.
+
Mutually exclusive with count, instance_ids.
+ +
@@ -388,6 +425,7 @@ Parameters
If you specify one or more instance IDs, only instances that have the specified IDs are returned.
+
Mutually exclusive with exact_count.
@@ -1295,6 +1333,7 @@ Examples tags: Env: "eni_on" instance_type: t2.micro + - name: start an instance with metadata options amazon.aws.ec2_instance: name: "public-metadataoptions-instance" @@ -1307,6 +1346,35 @@ Examples http_endpoint: enabled http_tokens: optional + # ensure number of instances running with a tag matches exact_count + - name: start multiple instances + amazon.aws.ec2_instance: + instance_type: t3.small + image_id: ami-123456 + exact_count: 5 + region: us-east-2 + vpc_subnet_id: subnet-0123456 + network: + assign_public_ip: yes + security_group: default + tags: + foo: bar + + # launches multiple instances - specific number of instances + - name: start specific number of multiple instances + amazon.aws.ec2_instance: + instance_type: t3.small + image_id: ami-123456 + count: 3 + region: us-east-2 + network: + assign_public_ip: yes + security_group: default + vpc_subnet_id: subnet-0123456 + state: present + tags: + foo: bar + Return Values diff --git a/docs/amazon.aws.s3_bucket_module.rst b/docs/amazon.aws.s3_bucket_module.rst index 32b04dc9d61..787f85dd7a8 100644 --- a/docs/amazon.aws.s3_bucket_module.rst +++ b/docs/amazon.aws.s3_bucket_module.rst @@ -705,6 +705,136 @@ Examples +Return Values +------------- +Common return values are documented `here `_, the following are the fields unique to this module: + +.. raw:: html + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
KeyReturnedDescription
+
+ encryption + +
+ string +
+
state=present +
Server-side encryption of the objects in the S3 bucket.
+
+
+
+ name + +
+ string +
+
state=present +
Name of the S3 bucket.
+
+
Sample:
+
2d3ce10a8210d36d6b4d23b822892074complex
+
+
+ object_ownership + +
+ string +
+
state=present +
S3 bucket's ownership controls.
+
+
Sample:
+
BucketOwnerPreferred
+
+
+ policy + +
+ dictionary +
+
state=present +
S3 bucket's policy.
+
+
Sample:
+
{'Statement': [{'Action': 's3:GetObject', 'Effect': 'Allow', 'Principal': '*', 'Resource': 'arn:aws:s3:::2d3ce10a8210d36d6b4d23b822892074complex/*', 'Sid': 'AddPerm'}], 'Version': '2012-10-17'}
+
+
+ requester_pays + +
+ string +
+
state=present +
Indicates that the requester was successfully charged for the request.
+
+
+
+ tags + +
+ dictionary +
+
state=present +
S3 bucket's tags.
+
+
Sample:
+
{'Tag1': 'tag1', 'Tag2': 'tag2'}
+
+
+ versioning + +
+ dictionary +
+
state=present +
S3 bucket's versioning configuration.
+
+
Sample:
+
{'MfaDelete': 'Disabled', 'Versioning': 'Enabled'}
+
+

+ Status ------ diff --git a/galaxy.yml b/galaxy.yml index 5ff48d4fa30..facf500e621 100644 --- a/galaxy.yml +++ b/galaxy.yml @@ -1,6 +1,6 @@ namespace: amazon name: aws -version: 2.1.0 +version: 2.2.0 readme: README.md authors: - Ansible (https://github.com/ansible)