diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 54811a94b41..e283be2e88a 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -5,6 +5,47 @@ community.aws Release Notes .. contents:: Topics +v1.4.0 +====== + +Minor Changes +------------- + +- aws_kms - add support for setting the deletion window using `pending_window` (PendingWindowInDays) (https://github.com/ansible-collections/community.aws/pull/200). +- aws_kms_info - Add ``key_id`` and ``alias`` parameters to support fetching a single key (https://github.com/ansible-collections/community.aws/pull/200). +- dynamodb_ttl - use ``botocore_at_least`` helper for checking the available botocore version (https://github.com/ansible-collections/community.aws/pull/280). +- ec2_instance - add automatic retries on all paginated queries for temporary errors (https://github.com/ansible-collections/community.aws/pull/373). +- ec2_instance - migrate to shared implementation of get_ec2_security_group_ids_from_names. The module will now return an error if the subnet provided isn't in the requested VPC. (https://github.com/ansible-collections/community.aws/pull/214) +- ec2_instance_info - added ``minimum_uptime`` option with alias ``uptime`` for filtering instances that have only been online for certain duration of time in minutes (https://github.com/ansible-collections/community.aws/pull/356). +- ec2_launch_template - Add retries on common AWS failures (https://github.com/ansible-collections/community.aws/pull/326). +- ec2_vpc_peer - use ``botocore_at_least`` helper for checking the available botocore version (https://github.com/ansible-collections/community.aws/pull/280). +- ecs_task - use ``botocore_at_least`` helper for checking the available botocore version (https://github.com/ansible-collections/community.aws/pull/280). +- route53 - migrated from boto to boto3 (https://github.com/ansible-collections/community.aws/pull/405). +- various community.aws modules - cleanup error handling to use ``is_boto3_error_code`` and ``is_boto3_error_message`` helpers (https://github.com/ansible-collections/community.aws/pull/268). +- various community.aws modules - cleanup of Python imports (https://github.com/ansible-collections/community.aws/pull/360). +- various community.aws modules - improve consistency of handling Boto3 exceptions (https://github.com/ansible-collections/community.aws/pull/268). +- various community.aws modules - migrate exception error message handling from fail_json to fail_json_aws (https://github.com/ansible-collections/community.aws/pull/361). + +Deprecated Features +------------------- + +- ec2_eip - formally deprecate the ``instance_id`` alias for ``device_id`` (https://github.com/ansible-collections/community.aws/pull/349). +- ec2_vpc_endpoint - deprecate the policy_file option and recommend using policy with a lookup (https://github.com/ansible-collections/community.aws/pull/366). + +Bugfixes +-------- + +- aws_kms - fixes issue where module execution fails without the kms:GetKeyRotationStatus permission. (https://github.com/ansible-collections/community.aws/pull/200). +- aws_kms_info - ensure that searching by tag works when tag only exists on some CMKs (https://github.com/ansible-collections/community.aws/issues/276). +- aws_s3_cors - fix element type for rules parameter. (https://github.com/ansible-collections/community.aws/pull/408). +- aws_ssm - fix the generation of CURL URL used to download Ansible Python file from S3 bucket by ```_get_url()``` due to due to non-assignment of aws region in the URL and not using V4 signature as specified for AWS S3 signature URL by ```_get_boto_client()``` in (https://github.com/ansible-collections/community.aws/pull/352). +- aws_ssm - fixed ``UnicodeEncodeError`` error when using unicode file names (https://github.com/ansible-collections/community.aws/pull/295). +- ec2_eip - fix eip association by instance id & private ip address due to case-sensitivity of the ``PrivateIpAddress`` parameter (https://github.com/ansible-collections/community.aws/pull/328). +- ec2_vpc_endpoint - ensure ``changed`` is correctly set when deleting an endpoint (https://github.com/ansible-collections/community.aws/pull/362). +- ec2_vpc_endpoint - fix exception when attempting to delete an endpoint which has already been deleted (https://github.com/ansible-collections/community.aws/pull/362). +- ecs_task - use `required_if` to enforce mandatory parameters based on specified operation (https://github.com/ansible-collections/community.aws/pull/402). +- elb_application_lb - during the removal of an instance, the associated listeners are also removed. + v1.3.0 ====== diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml index 25102ab8cc6..156c7c57eba 100644 --- a/changelogs/changelog.yaml +++ b/changelogs/changelog.yaml @@ -802,3 +802,80 @@ releases: name: s3_metrics_configuration namespace: '' release_date: '2020-12-10' + 1.4.0: + changes: + bugfixes: + - aws_kms - fixes issue where module execution fails without the kms:GetKeyRotationStatus + permission. (https://github.com/ansible-collections/community.aws/pull/200). + - aws_kms_info - ensure that searching by tag works when tag only exists on + some CMKs (https://github.com/ansible-collections/community.aws/issues/276). + - aws_s3_cors - fix element type for rules parameter. (https://github.com/ansible-collections/community.aws/pull/408). + - aws_ssm - fix the generation of CURL URL used to download Ansible Python file + from S3 bucket by ```_get_url()``` due to due to non-assignment of aws region + in the URL and not using V4 signature as specified for AWS S3 signature URL + by ```_get_boto_client()``` in (https://github.com/ansible-collections/community.aws/pull/352). + - aws_ssm - fixed ``UnicodeEncodeError`` error when using unicode file names + (https://github.com/ansible-collections/community.aws/pull/295). + - ec2_eip - fix eip association by instance id & private ip address due to case-sensitivity + of the ``PrivateIpAddress`` parameter (https://github.com/ansible-collections/community.aws/pull/328). + - ec2_vpc_endpoint - ensure ``changed`` is correctly set when deleting an endpoint + (https://github.com/ansible-collections/community.aws/pull/362). + - ec2_vpc_endpoint - fix exception when attempting to delete an endpoint which + has already been deleted (https://github.com/ansible-collections/community.aws/pull/362). + - ecs_task - use `required_if` to enforce mandatory parameters based on specified + operation (https://github.com/ansible-collections/community.aws/pull/402). + - elb_application_lb - during the removal of an instance, the associated listeners + are also removed. + deprecated_features: + - ec2_eip - formally deprecate the ``instance_id`` alias for ``device_id`` (https://github.com/ansible-collections/community.aws/pull/349). + - ec2_vpc_endpoint - deprecate the policy_file option and recommend using policy + with a lookup (https://github.com/ansible-collections/community.aws/pull/366). + minor_changes: + - aws_kms - add support for setting the deletion window using `pending_window` + (PendingWindowInDays) (https://github.com/ansible-collections/community.aws/pull/200). + - aws_kms_info - Add ``key_id`` and ``alias`` parameters to support fetching + a single key (https://github.com/ansible-collections/community.aws/pull/200). + - dynamodb_ttl - use ``botocore_at_least`` helper for checking the available + botocore version (https://github.com/ansible-collections/community.aws/pull/280). + - ec2_instance - add automatic retries on all paginated queries for temporary + errors (https://github.com/ansible-collections/community.aws/pull/373). + - ec2_instance - migrate to shared implementation of get_ec2_security_group_ids_from_names. + The module will now return an error if the subnet provided isn't in the requested + VPC. (https://github.com/ansible-collections/community.aws/pull/214) + - ec2_instance_info - added ``minimum_uptime`` option with alias ``uptime`` + for filtering instances that have only been online for certain duration of + time in minutes (https://github.com/ansible-collections/community.aws/pull/356). + - ec2_launch_template - Add retries on common AWS failures (https://github.com/ansible-collections/community.aws/pull/326). + - ec2_vpc_peer - use ``botocore_at_least`` helper for checking the available + botocore version (https://github.com/ansible-collections/community.aws/pull/280). + - ecs_task - use ``botocore_at_least`` helper for checking the available botocore + version (https://github.com/ansible-collections/community.aws/pull/280). + - route53 - migrated from boto to boto3 (https://github.com/ansible-collections/community.aws/pull/405). + - various community.aws modules - cleanup error handling to use ``is_boto3_error_code`` + and ``is_boto3_error_message`` helpers (https://github.com/ansible-collections/community.aws/pull/268). + - various community.aws modules - cleanup of Python imports (https://github.com/ansible-collections/community.aws/pull/360). + - various community.aws modules - improve consistency of handling Boto3 exceptions + (https://github.com/ansible-collections/community.aws/pull/268). + - various community.aws modules - migrate exception error message handling from + fail_json to fail_json_aws (https://github.com/ansible-collections/community.aws/pull/361). + fragments: + - 200-aws_kms-deletion.yaml + - 214-get_ec2_security_group_ids_from_names.yml + - 268-is_boto3_error.yml + - 280-cleanup-botocore_at_least.yml + - 295-connection-aws_ssm.yml + - 326-launch_template_retry.yml + - 328-fix-ec2_eip-instance-id-private-ip-address.yml + - 349-ec2_eip-deprecate-instance_id.yml + - 350_elb_application_lb_purges_listeners.yaml + - 352-fix-aws-region-and-v4-signature-for-s3-boto-client.yml + - 356_add_minimum_uptime_parameter.yaml + - 360-imports-cleanup.yml + - 361-fail_json_aws.yml + - 362-ec2_vpc_endpoint-deletion-changed.yml + - 366-ec2_vpc_endpoint-policy_file.yml + - 373-ec2_instance-retry-pagination.yml + - 402-ecs_task-mandatory_params.yml + - 404-fix-dict-element-for-rule-param-in-aws-s3-cors.yml + - 405-route53-boto3.yml + release_date: '2021-02-16' diff --git a/changelogs/fragments/200-aws_kms-deletion.yaml b/changelogs/fragments/200-aws_kms-deletion.yaml deleted file mode 100644 index 4da546c93c0..00000000000 --- a/changelogs/fragments/200-aws_kms-deletion.yaml +++ /dev/null @@ -1,6 +0,0 @@ -bugfixes: -- aws_kms - fixes issue where module execution fails without the kms:GetKeyRotationStatus permission. (https://github.com/ansible-collections/community.aws/pull/200). -- aws_kms_info - ensure that searching by tag works when tag only exists on some CMKs (https://github.com/ansible-collections/community.aws/issues/276). -minor_changes: -- aws_kms - add support for setting the deletion window using `pending_window` (PendingWindowInDays) (https://github.com/ansible-collections/community.aws/pull/200). -- aws_kms_info - Add ``key_id`` and ``alias`` parameters to support fetching a single key (https://github.com/ansible-collections/community.aws/pull/200). diff --git a/changelogs/fragments/214-get_ec2_security_group_ids_from_names.yml b/changelogs/fragments/214-get_ec2_security_group_ids_from_names.yml deleted file mode 100644 index 65feeec7848..00000000000 --- a/changelogs/fragments/214-get_ec2_security_group_ids_from_names.yml +++ /dev/null @@ -1,4 +0,0 @@ -minor_changes: -- ec2_instance - migrate to shared implementation of get_ec2_security_group_ids_from_names. - The module will now return an error if the subnet provided isn't in the requested VPC. - (https://github.com/ansible-collections/community.aws/pull/214) diff --git a/changelogs/fragments/268-is_boto3_error.yml b/changelogs/fragments/268-is_boto3_error.yml deleted file mode 100644 index ad7b2ff1559..00000000000 --- a/changelogs/fragments/268-is_boto3_error.yml +++ /dev/null @@ -1,3 +0,0 @@ -minor_changes: -- various community.aws modules - cleanup error handling to use ``is_boto3_error_code`` and ``is_boto3_error_message`` helpers (https://github.com/ansible-collections/community.aws/pull/268). -- various community.aws modules - improve consistency of handling Boto3 exceptions (https://github.com/ansible-collections/community.aws/pull/268). diff --git a/changelogs/fragments/280-cleanup-botocore_at_least.yml b/changelogs/fragments/280-cleanup-botocore_at_least.yml deleted file mode 100644 index 359bfaa110e..00000000000 --- a/changelogs/fragments/280-cleanup-botocore_at_least.yml +++ /dev/null @@ -1,4 +0,0 @@ -minor_changes: -- dynamodb_ttl - use ``botocore_at_least`` helper for checking the available botocore version (https://github.com/ansible-collections/community.aws/pull/280). -- ec2_vpc_peer - use ``botocore_at_least`` helper for checking the available botocore version (https://github.com/ansible-collections/community.aws/pull/280). -- ecs_task - use ``botocore_at_least`` helper for checking the available botocore version (https://github.com/ansible-collections/community.aws/pull/280). diff --git a/changelogs/fragments/295-connection-aws_ssm.yml b/changelogs/fragments/295-connection-aws_ssm.yml deleted file mode 100644 index 049d3d9f334..00000000000 --- a/changelogs/fragments/295-connection-aws_ssm.yml +++ /dev/null @@ -1,2 +0,0 @@ -bugfixes: -- aws_ssm - fixed ``UnicodeEncodeError`` error when using unicode file names (https://github.com/ansible-collections/community.aws/pull/295). diff --git a/changelogs/fragments/326-launch_template_retry.yml b/changelogs/fragments/326-launch_template_retry.yml deleted file mode 100644 index ab7506d8847..00000000000 --- a/changelogs/fragments/326-launch_template_retry.yml +++ /dev/null @@ -1,2 +0,0 @@ -minor_changes: -- ec2_launch_template - Add retries on common AWS failures (https://github.com/ansible-collections/community.aws/pull/326). diff --git a/changelogs/fragments/328-fix-ec2_eip-instance-id-private-ip-address.yml b/changelogs/fragments/328-fix-ec2_eip-instance-id-private-ip-address.yml deleted file mode 100644 index 8701cdd8694..00000000000 --- a/changelogs/fragments/328-fix-ec2_eip-instance-id-private-ip-address.yml +++ /dev/null @@ -1,2 +0,0 @@ -bugfixes: - - ec2_eip - fix eip association by instance id & private ip address due to case-sensitivity of the ``PrivateIpAddress`` parameter (https://github.com/ansible-collections/community.aws/pull/328). diff --git a/changelogs/fragments/349-ec2_eip-deprecate-instance_id.yml b/changelogs/fragments/349-ec2_eip-deprecate-instance_id.yml deleted file mode 100644 index 35bfd8835c7..00000000000 --- a/changelogs/fragments/349-ec2_eip-deprecate-instance_id.yml +++ /dev/null @@ -1,2 +0,0 @@ -deprecated_features: -- ec2_eip - formally deprecate the ``instance_id`` alias for ``device_id`` (https://github.com/ansible-collections/community.aws/pull/349). diff --git a/changelogs/fragments/350_elb_application_lb_purges_listeners.yaml b/changelogs/fragments/350_elb_application_lb_purges_listeners.yaml deleted file mode 100644 index 616ffa019bd..00000000000 --- a/changelogs/fragments/350_elb_application_lb_purges_listeners.yaml +++ /dev/null @@ -1,3 +0,0 @@ ---- -bugfixes: -- elb_application_lb - during the removal of an instance, the associated listeners are also removed. diff --git a/changelogs/fragments/352-fix-aws-region-and-v4-signature-for-s3-boto-client.yml b/changelogs/fragments/352-fix-aws-region-and-v4-signature-for-s3-boto-client.yml deleted file mode 100644 index 8fe59379698..00000000000 --- a/changelogs/fragments/352-fix-aws-region-and-v4-signature-for-s3-boto-client.yml +++ /dev/null @@ -1,2 +0,0 @@ -bugfixes: - - aws_ssm - fix the generation of CURL URL used to download Ansible Python file from S3 bucket by ```_get_url()``` due to due to non-assignment of aws region in the URL and not using V4 signature as specified for AWS S3 signature URL by ```_get_boto_client()``` in (https://github.com/ansible-collections/community.aws/pull/352). \ No newline at end of file diff --git a/changelogs/fragments/356_add_minimum_uptime_parameter.yaml b/changelogs/fragments/356_add_minimum_uptime_parameter.yaml deleted file mode 100644 index c436c96f0ea..00000000000 --- a/changelogs/fragments/356_add_minimum_uptime_parameter.yaml +++ /dev/null @@ -1,3 +0,0 @@ ---- -minor_changes: -- ec2_instance_info - added ``minimum_uptime`` option with alias ``uptime`` for filtering instances that have only been online for certain duration of time in minutes (https://github.com/ansible-collections/community.aws/pull/356). diff --git a/changelogs/fragments/360-imports-cleanup.yml b/changelogs/fragments/360-imports-cleanup.yml deleted file mode 100644 index dae43e8d1ec..00000000000 --- a/changelogs/fragments/360-imports-cleanup.yml +++ /dev/null @@ -1,2 +0,0 @@ -minor_changes: -- various community.aws modules - cleanup of Python imports (https://github.com/ansible-collections/community.aws/pull/360). diff --git a/changelogs/fragments/361-fail_json_aws.yml b/changelogs/fragments/361-fail_json_aws.yml deleted file mode 100644 index 6c7fc1ae1fe..00000000000 --- a/changelogs/fragments/361-fail_json_aws.yml +++ /dev/null @@ -1,2 +0,0 @@ -minor_changes: -- various community.aws modules - migrate exception error message handling from fail_json to fail_json_aws (https://github.com/ansible-collections/community.aws/pull/361). diff --git a/changelogs/fragments/362-ec2_vpc_endpoint-deletion-changed.yml b/changelogs/fragments/362-ec2_vpc_endpoint-deletion-changed.yml deleted file mode 100644 index cb07235f8c0..00000000000 --- a/changelogs/fragments/362-ec2_vpc_endpoint-deletion-changed.yml +++ /dev/null @@ -1,3 +0,0 @@ -bugfixes: -- ec2_vpc_endpoint - ensure ``changed`` is correctly set when deleting an endpoint (https://github.com/ansible-collections/community.aws/pull/362). -- ec2_vpc_endpoint - fix exception when attempting to delete an endpoint which has already been deleted (https://github.com/ansible-collections/community.aws/pull/362). diff --git a/changelogs/fragments/366-ec2_vpc_endpoint-policy_file.yml b/changelogs/fragments/366-ec2_vpc_endpoint-policy_file.yml deleted file mode 100644 index 1057736bc5b..00000000000 --- a/changelogs/fragments/366-ec2_vpc_endpoint-policy_file.yml +++ /dev/null @@ -1,2 +0,0 @@ -deprecated_features: -- ec2_vpc_endpoint - deprecate the policy_file option and recommend using policy with a lookup (https://github.com/ansible-collections/community.aws/pull/366). diff --git a/changelogs/fragments/373-ec2_instance-retry-pagination.yml b/changelogs/fragments/373-ec2_instance-retry-pagination.yml deleted file mode 100644 index ff9ddb80804..00000000000 --- a/changelogs/fragments/373-ec2_instance-retry-pagination.yml +++ /dev/null @@ -1,2 +0,0 @@ -minor_changes: -- ec2_instance - add automatic retries on all paginated queries for temporary errors (https://github.com/ansible-collections/community.aws/pull/373). diff --git a/changelogs/fragments/402-ecs_task-mandatory_params.yml b/changelogs/fragments/402-ecs_task-mandatory_params.yml deleted file mode 100644 index 924f15507b6..00000000000 --- a/changelogs/fragments/402-ecs_task-mandatory_params.yml +++ /dev/null @@ -1,3 +0,0 @@ ---- -bugfixes: -- ecs_task - use `required_if` to enforce mandatory parameters based on specified operation (https://github.com/ansible-collections/community.aws/pull/402). diff --git a/changelogs/fragments/404-fix-dict-element-for-rule-param-in-aws-s3-cors.yml b/changelogs/fragments/404-fix-dict-element-for-rule-param-in-aws-s3-cors.yml deleted file mode 100644 index e6eb68bbabd..00000000000 --- a/changelogs/fragments/404-fix-dict-element-for-rule-param-in-aws-s3-cors.yml +++ /dev/null @@ -1,2 +0,0 @@ -bugfixes: -- aws_s3_cors - fix element type for rules parameter. (https://github.com/ansible-collections/community.aws/pull/408). diff --git a/changelogs/fragments/405-route53-boto3.yml b/changelogs/fragments/405-route53-boto3.yml deleted file mode 100644 index eb8f59fb18a..00000000000 --- a/changelogs/fragments/405-route53-boto3.yml +++ /dev/null @@ -1,2 +0,0 @@ -minor_changes: -- route53 - migrated from boto to boto3 (https://github.com/ansible-collections/community.aws/pull/405). diff --git a/docs/community.aws.aws_kms_info_module.rst b/docs/community.aws.aws_kms_info_module.rst index c8a33762150..d13db70e882 100644 --- a/docs/community.aws.aws_kms_info_module.rst +++ b/docs/community.aws.aws_kms_info_module.rst @@ -41,6 +41,24 @@ Parameters Choices/Defaults Comments + + +
+ alias + +
+ string +
+
added in 1.4.0
+ + + + +
Alias for key.
+
Mutually exclusive with key_id and filters.
+

aliases: key_alias
+ +
@@ -159,6 +177,25 @@ Parameters
A dict of filters to apply. Each dict item consists of a filter key and a filter value. The filters aren't natively supported by boto3, but are supported to provide similar functionality to other modules. Standard tag filters (tag-key, tag-value and tag:tagName) are available, as are key-id and alias
+
Mutually exclusive with alias and key_id.
+ + + + +
+ key_id + +
+ string +
+
added in 1.4.0
+ + + + +
Key ID or ARN of the key.
+
Mutually exclusive with alias and filters.
+

aliases: key_arn
diff --git a/docs/community.aws.aws_kms_module.rst b/docs/community.aws.aws_kms_module.rst index aee2ec1068d..210d4fcdee7 100644 --- a/docs/community.aws.aws_kms_module.rst +++ b/docs/community.aws.aws_kms_module.rst @@ -330,6 +330,26 @@ Parameters

aliases: key_arn
+ + +
+ pending_window + +
+ integer +
+
added in 1.4.0
+ + + + +
The number of days between requesting deletion of the CMK and when it will actually be deleted.
+
Only used when state=absent and the CMK has not yet been deleted.
+
Valid values are between 7 and 30 (inclusive).
+
See also: https://docs.aws.amazon.com/kms/latest/APIReference/API_ScheduleKeyDeletion.html#KMS-ScheduleKeyDeletion-request-PendingWindowInDays
+

aliases: deletion_delay
+ +
diff --git a/docs/community.aws.aws_s3_cors_module.rst b/docs/community.aws.aws_s3_cors_module.rst index 31f8b5bd7ad..d0ca89d016d 100644 --- a/docs/community.aws.aws_s3_cors_module.rst +++ b/docs/community.aws.aws_s3_cors_module.rst @@ -202,7 +202,7 @@ Parameters
list - / elements=string + / elements=dictionary
diff --git a/docs/community.aws.ec2_eip_module.rst b/docs/community.aws.ec2_eip_module.rst index efce79cd9fd..dd674bbb9d4 100644 --- a/docs/community.aws.ec2_eip_module.rst +++ b/docs/community.aws.ec2_eip_module.rst @@ -162,6 +162,7 @@ Parameters
The id of the device for the EIP. Can be an EC2 Instance id or Elastic Network Interface (ENI) id.
+
The instance_id alias has been deprecated and will be removed after 2022-12-01.

aliases: instance_id
diff --git a/docs/community.aws.ec2_instance_info_module.rst b/docs/community.aws.ec2_instance_info_module.rst index 3e64fafff6b..dbc5718c88e 100644 --- a/docs/community.aws.ec2_instance_info_module.rst +++ b/docs/community.aws.ec2_instance_info_module.rst @@ -180,6 +180,22 @@ Parameters
If you specify one or more instance IDs, only instances that have the specified IDs are returned.
+ + +
+ minimum_uptime + +
+ integer +
+ + + + +
Minimum running uptime in minutes of instances. For example if uptime is 60 return all instances that have run more than 60 minutes.
+

aliases: uptime
+ +
@@ -295,6 +311,15 @@ Examples filters: instance-state-name: [ "shutting-down", "stopping", "stopped" ] + - name: Gather information about any instance with Name beginning with RHEL and an uptime of at least 60 minutes + community.aws.ec2_instance_info: + region: "{{ ec2_region }}" + uptime: 60 + filters: + "tag:Name": "RHEL-*" + instance-state-name: [ "running"] + register: ec2_node_info + Return Values diff --git a/docs/community.aws.ec2_metric_alarm_module.rst b/docs/community.aws.ec2_metric_alarm_module.rst index 290374d62f6..c15290999b5 100644 --- a/docs/community.aws.ec2_metric_alarm_module.rst +++ b/docs/community.aws.ec2_metric_alarm_module.rst @@ -554,7 +554,7 @@ Examples period: 300 evaluation_periods: 3 unit: "Percent" - description: "This will alarm when a bamboo slave's cpu usage average is lower than 5% for 15 minutes " + description: "This will alarm when a instance's CPU usage average is lower than 5% for 15 minutes" dimensions: {'InstanceId':'i-XXX'} alarm_actions: ["action1","action2"] diff --git a/docs/community.aws.ec2_vpc_endpoint_module.rst b/docs/community.aws.ec2_vpc_endpoint_module.rst index 130139ed516..2109632c1c6 100644 --- a/docs/community.aws.ec2_vpc_endpoint_module.rst +++ b/docs/community.aws.ec2_vpc_endpoint_module.rst @@ -193,6 +193,7 @@ Parameters
The path to the properly json formatted policy file, see https://github.com/ansible/ansible/issues/7005#issuecomment-42894813 on how to use it properly. Cannot be used with policy.
Option when creating an endpoint. If not provided AWS will utilise a default policy which provides full access to the service.
+
This option has been deprecated and will be removed after 2022-12-01 to maintain the existing functionality please use the policy option and a file lookup.

aliases: policy_path
diff --git a/docs/community.aws.ec2_vpc_nat_gateway_module.rst b/docs/community.aws.ec2_vpc_nat_gateway_module.rst index ec295043144..a158fdd5ddc 100644 --- a/docs/community.aws.ec2_vpc_nat_gateway_module.rst +++ b/docs/community.aws.ec2_vpc_nat_gateway_module.rst @@ -244,6 +244,26 @@ Parameters

aliases: aws_profile
+ + +
+ purge_tags + +
+ boolean +
+
added in 1.4.0
+ + + + + +
Remove tags not listed in tags.
+ +
@@ -333,6 +353,24 @@ Parameters
The id of the subnet to create the NAT Gateway in. This is required with the present option.
+ + +
+ tags + +
+ dictionary +
+
added in 1.4.0
+ + + + +
A dict of tags to apply to the internet gateway.
+
To remove all tags set tags={} and purge_tags=true.
+

aliases: resource_tags
+ +
@@ -478,6 +516,17 @@ Examples wait_timeout: 300 region: ap-southeast-2 + - name: Create new nat gateway using an allocation-id and tags. + community.aws.ec2_vpc_nat_gateway: + state: present + subnet_id: subnet-12345678 + allocation_id: eipalloc-12345678 + region: ap-southeast-2 + tags: + Tag1: tag1 + Tag2: tag2 + register: new_nat_gateway + Return Values @@ -577,6 +626,23 @@ Common return values are documented `here subnet-12345 + + +
+ tags + +
+ dictionary +
+ + When tags are present. + +
The tags associated the VPC NAT Gateway.
+
+
Sample:
+
{'tags': {'Ansible': 'Test'}}
+ +
diff --git a/docs/community.aws.ecs_task_module.rst b/docs/community.aws.ecs_task_module.rst index ce9bbb96799..3b0a99473d7 100644 --- a/docs/community.aws.ecs_task_module.rst +++ b/docs/community.aws.ecs_task_module.rst @@ -120,6 +120,7 @@ Parameters
string + / required
@@ -282,6 +283,9 @@ Parameters
Which task operation to execute.
+
When operation=run task_definition must be set.
+
When operation=start both task_definition and container_instances must be set.
+
When operation=stop both task_definition and task must be set.
@@ -393,7 +397,7 @@ Parameters -
The task to stop.
+
The ARN of the task to stop.
@@ -408,7 +412,7 @@ Parameters -
The task definition to start or run.
+
The task definition to start, run or stop.
diff --git a/docs/community.aws.route53_module.rst b/docs/community.aws.route53_module.rst index 2c18875aba8..f9a26d702e2 100644 --- a/docs/community.aws.route53_module.rst +++ b/docs/community.aws.route53_module.rst @@ -25,8 +25,10 @@ Requirements ------------ The below requirements are needed on the host that executes this module. -- python >= 2.6 +- boto - boto3 +- botocore +- python >= 2.6 Parameters @@ -601,7 +603,6 @@ Examples ttl: 7200 value: 1.1.1.1,2.2.2.2,3.3.3.3 wait: yes - - name: Update new.foo.com as an A record with a list of 3 IPs and wait until the changes have been replicated community.aws.route53: state: present @@ -614,7 +615,6 @@ Examples - 2.2.2.2 - 3.3.3.3 wait: yes - - name: Retrieve the details for new.foo.com community.aws.route53: state: get @@ -622,7 +622,6 @@ Examples record: new.foo.com type: A register: rec - - name: Delete new.foo.com A record using the results from the get command community.aws.route53: state: absent @@ -631,7 +630,6 @@ Examples ttl: "{{ rec.set.ttl }}" type: "{{ rec.set.type }}" value: "{{ rec.set.value }}" - # Add an AAAA record. Note that because there are colons in the value # that the IPv6 address must be quoted. Also shows using the old form command=create. - name: Add an AAAA record @@ -642,7 +640,6 @@ Examples type: AAAA ttl: 7200 value: "::1" - # For more information on SRV records see: # https://en.wikipedia.org/wiki/SRV_record - name: Add a SRV record with multiple fields for a service on port 22222 @@ -652,7 +649,6 @@ Examples record: "_example-service._tcp.foo.com" type: SRV 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: - name: Add a TXT record. @@ -663,7 +659,6 @@ Examples type: TXT ttl: 7200 value: '"bar"' - - name: Add an alias record that points to an Amazon ELB community.aws.route53: state: present @@ -673,7 +668,6 @@ Examples value: "{{ elb_dns_name }}" alias: True alias_hosted_zone_id: "{{ elb_zone_id }}" - - name: Retrieve the details for elb.foo.com community.aws.route53: state: get @@ -681,7 +675,6 @@ Examples record: elb.foo.com type: A register: rec - - name: Delete an alias record using the results from the get command community.aws.route53: state: absent @@ -692,7 +685,6 @@ Examples value: "{{ rec.set.value }}" alias: True alias_hosted_zone_id: "{{ rec.set.alias_hosted_zone_id }}" - - name: Add an alias record that points to an Amazon ELB and evaluates it health community.aws.route53: state: present @@ -703,7 +695,6 @@ Examples alias: True alias_hosted_zone_id: "{{ elb_zone_id }}" alias_evaluate_target_health: True - - name: Add an AAAA record with Hosted Zone ID community.aws.route53: state: present @@ -713,7 +704,6 @@ Examples type: AAAA ttl: 7200 value: "::1" - - name: Use a routing policy to distribute traffic community.aws.route53: state: present @@ -726,7 +716,6 @@ Examples identifier: "host1@www" weight: 100 health_check: "d994b780-3150-49fd-9205-356abdd42e75" - - name: Add a CAA record (RFC 6844) community.aws.route53: state: present diff --git a/docs/community.aws.s3_lifecycle_module.rst b/docs/community.aws.s3_lifecycle_module.rst index 9790bd8f547..c2a77f274b1 100644 --- a/docs/community.aws.s3_lifecycle_module.rst +++ b/docs/community.aws.s3_lifecycle_module.rst @@ -25,9 +25,8 @@ Requirements ------------ The below requirements are needed on the host that executes this module. -- boto - python >= 2.6 -- python-dateutil +- boto Parameters diff --git a/galaxy.yml b/galaxy.yml index 65fd909bbaa..19f01d6fc0c 100644 --- a/galaxy.yml +++ b/galaxy.yml @@ -1,6 +1,6 @@ namespace: community name: aws -version: 1.3.0 +version: 1.4.0 readme: README.md authors: - Ansible (https://github.com/ansible) @@ -8,7 +8,7 @@ description: null license_file: COPYING tags: [community, aws, cloud, amazon] dependencies: - amazon.aws: '>=1.3.0' + amazon.aws: '>=1.4.0' repository: https://github.com/ansible-collections/community.aws documentation: https://github.com/ansible-collections/community.aws/tree/main/docs homepage: https://github.com/ansible-collections/community.aws diff --git a/tests/requirements.yml b/tests/requirements.yml index d7efc78d867..49fb712e34e 100644 --- a/tests/requirements.yml +++ b/tests/requirements.yml @@ -1,7 +1,7 @@ integration_tests_dependencies: -- amazon.aws >= 1.3.0 +- amazon.aws >= 1.4.0 - ansible.windows - community.crypto - community.general unit_tests_dependencies: -- amazon.aws >= 1.3.0 +- amazon.aws >= 1.4.0