未验证 提交 c7720d7b 编写于 作者: M Mark Chappell 提交者: GitHub

Prepare release 4.1.0 (#1391)

Prepare release 4.1.0

SUMMARY
Latest minor release in the 4.x series
ISSUE TYPE

Docs Pull Request

COMPONENT NAME
CHANGELOG.rst
README.md
changelogs/changelog.yaml
docs/
galaxy.yml
ADDITIONAL INFORMATION

Reviewed-by: Alina Buzachis <None>
上级 17773b6c
......@@ -5,6 +5,70 @@ community.aws Release Notes
.. contents:: Topics
v4.1.0
======
Minor Changes
-------------
- aws_glue_connection - added new ``raw_connection_parameters`` return key which doesn't snake case the connection parameters (https://github.com/ansible-collections/community.aws/pull/518).
- aws_ssm_parameter_store - added support for check_mode (https://github.com/ansible-collections/community.aws/pull/1309).
- cloudwatchevent_rule - Added ``targets.input_transformer.input_paths_map`` and ``targets.input_transformer.input_template`` parameters to support configuring on CloudWatch event rule input transformation (https://github.com/ansible-collections/community.aws/pull/623).
- cloudwatchevent_rule - Applied validation of ``targets`` arguments (https://github.com/ansible-collections/community.aws/issues/201).
- cloudwatchlogs_log_group - Added check_mode support (https://github.com/ansible-collections/community.aws/pull/1373).
- ec2_launch_template - Adds support for specifying the ``source_version`` upon which template updates are based (https://github.com/ansible-collections/community.aws/pull/239).
- ec2_scaling_policy - add TargetTrackingScaling as a scaling policy option (https://github.com/ansible-collections/community.aws/pull/771)
- ec2_vpc_vgw_info - updated to not throw an error when run in check_mode (https://github.com/ansible-collections/community.aws/issues/137).
- ecs_ecr - add `force_absent` parameter for removing repositories that contain images (https://github.com/ansible-collections/community.aws/pull/1316).
- ecs_service - add ``wait`` parameter and waiter for deleting services (https://github.com/ansible-collections/community.aws/pull/1209).
- ecs_service - added ``tags`` and ``tag_propagation`` support to the module (https://github.com/ansible-collections/community.aws/pull/543).
- ecs_service - added parameter ``deployment_controller`` so service can be controlled by Code Deploy (https://github.com/ansible-collections/community.aws/pull/340).
- ecs_task - add ``wait`` parameter and waiter for running and stopping tasks (https://github.com/ansible-collections/community.aws/pull/1209).
- elasticache_info - added ``replication_group`` to the returned information for an elasticache cluster (https://github.com/ansible-collections/community.aws/pull/646).
- iam_policy - added support for ``--diff`` mode (https://github.com/ansible-collections/community.aws/issues/560).
- iam_policy - attempts to continue when read requests are denied by IAM policy (https://github.com/ansible-collections/community.aws/pull/1375).
- iam_server_certificate - the deprecation for the ``iam_cert`` alias has been extended from release 4.0.0 to release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/1257).
- iam_server_certificate - the deprecations for ``cert_chain``, ``cert``, ``key`` and ``dup_ok`` have been extended from release 4.0.0 to release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/1256).
- lambda_info - add return key ``functions`` which returns a list of dictionaries instead of the previously returned ``function``, which returned a dictionary of dictionaries (https://github.com/ansible-collections/community.aws/pull/1239).
- lambda_info - now returns basic configuration information of each lambda function, regardless of query (https://github.com/ansible-collections/community.aws/pull/1239).
- rds_instance_snapshot - the deprecation for the ``rds_snapshot`` alias has been extended from release 4.0.0 to release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/1257).
- route53_health_check - Added new parameter ``health_check_id`` with alias ``id`` to allow update and delete health check by ID (https://github.com/ansible-collections/community.aws/pull/1143).
- route53_health_check - Added new parameter ``use_unique_names`` used with new parameter ``health_check_name`` with alias ``name`` to set health check name as unique identifier (https://github.com/ansible-collections/community.aws/pull/1143).
- s3_sync - improves error handling during ``HEAD`` operation to compare existing files (https://github.com/ansible-collections/community.aws/issues/58).
- secretsmanager_secret - add support for storing JSON in secrets (https://github.com/ansible-collections/community.aws/issues/656).
- sns_topic - Added ``attributes`` parameter to ``subscriptions`` items with support for RawMessageDelievery (SQS)
Deprecated Features
-------------------
- aws_glue_connection - the ``connection_parameters`` return key has been deprecated and will be removed in a release after 2024-06-01, it is being replaced by the ``raw_connection_parameters`` key (https://github.com/ansible-collections/community.aws/pull/518).
- community.aws collection - due to the AWS SDKs announcing the end of support for Python less than 3.7 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) support for Python less than 3.7 by this collection has been deprecated and will be removed in a release after 2023-05-31 (https://github.com/ansible-collections/community.aws/pull/1361).
- iam_policy - the ``policies`` return value has been renamed ``policy_names`` and will be removed in a release after 2024-08-01, both values are currently returned (https://github.com/ansible-collections/community.aws/pull/1375).
- lambda_info - The ``function`` return key returns a dictionary of dictionaries and has been deprecated. In a release after 2025-01-01, this key will be removed in favor of ``functions``, which returns a list of dictionaries (https://github.com/ansible-collections/community.aws/pull/1239).
- route53_info - The CamelCase return values for ```DelegationSets```, ```CheckerIpRanges```, and ```HealthCheck``` have been deprecated, in the future release you must use snake_case return values ```delegation_sets```, ```checker_ip_ranges```, and ```health_check``` instead respectively" (https://github.com/ansible-collections/community.aws/pull/1322).
Bugfixes
--------
- aws_api_gateway_domain - added the ``aws_api_gateway_domain`` module to the aws module_defaults group (https://github.com/ansible-collections/community.aws/pull/1283).
- aws_config_aggregator - Fix `KeyError` when updating existing aggregator (https://github.com/ansible-collections/community.aws/pull/645).
- aws_config_aggregator - Fix idempotency when ``account_sources`` parameter is not specified (https://github.com/ansible-collections/community.aws/pull/645).
- aws_ssm - pull S3 bucket region for session generated for file transfer during playbooks (https://github.com/ansible-collections/community.aws/issues/1190).
- aws_ssm_parameter_store - fixed bug where module wasn't consistently idempotent (https://github.com/ansible-collections/community.aws/pull/1309).
- cloudfront_response_headers_policy - added the ``cloudfront_response_headers_policy`` module to the aws module_defaults group (https://github.com/ansible-collections/community.aws/pull/1283).
- ec2_vpc_peer - fix idempotency when requester/accepter is reversed (https://github.com/ansible-collections/community.aws/issues/580).
- kms_key_info - handle access denied errors more liberally (https://github.com/ansible-collections/community.aws/issues/206).
- route53 - fixes bug preventing creating a DNS record with a weight of zero (https://github.com/ansible-collections/community.aws/issues/1378)
- route53_info - fix ``max_items`` parameter when used with non-paginated commands (https://github.com/ansible-collections/community.aws/issues/1383).
- sns_topic - fix bug which prevented the module being used in GovCloud (https://github.com/ansible-collections/community.aws/issues/836).
New Modules
-----------
- autoscaling_complete_lifecycle_action - Completes the lifecycle action of an instance
- aws_glue_crawler - Manage an AWS Glue crawler
- lightsail_static_ip - Manage static IP addresses in AWS Lightsail
v4.0.0
======
......
......@@ -43,6 +43,7 @@ Name | Description
### Modules
Name | Description
--- | ---
[community.aws.autoscaling_complete_lifecycle_action](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.autoscaling_complete_lifecycle_action_module.rst)|Completes the lifecycle action of an instance
[community.aws.aws_acm](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.aws_acm_module.rst)|Upload and delete certificates in the AWS Certificate Manager service
[community.aws.aws_acm_info](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.aws_acm_info_module.rst)|Retrieve certificate information from AWS Certificate Manager service
[community.aws.aws_api_gateway](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.aws_api_gateway_module.rst)|Manage AWS API Gateway APIs
......@@ -67,6 +68,7 @@ Name | Description
[community.aws.aws_eks_cluster](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.aws_eks_cluster_module.rst)|Manage Elastic Kubernetes Service Clusters
[community.aws.aws_elasticbeanstalk_app](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.aws_elasticbeanstalk_app_module.rst)|Create, update, and delete an elastic beanstalk application
[community.aws.aws_glue_connection](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.aws_glue_connection_module.rst)|Manage an AWS Glue connection
[community.aws.aws_glue_crawler](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.aws_glue_crawler_module.rst)|Manage an AWS Glue crawler
[community.aws.aws_glue_job](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.aws_glue_job_module.rst)|Manage an AWS Glue job
[community.aws.aws_inspector_target](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.aws_inspector_target_module.rst)|Create, Update and Delete Amazon Inspector Assessment Targets
[community.aws.aws_kms](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.aws_kms_module.rst)|Perform various KMS management tasks
......@@ -189,6 +191,7 @@ Name | Description
[community.aws.lambda_info](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.lambda_info_module.rst)|Gathers AWS Lambda function details
[community.aws.lambda_policy](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.lambda_policy_module.rst)|Creates, updates or deletes AWS Lambda policy statements.
[community.aws.lightsail](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.lightsail_module.rst)|Manage instances in AWS Lightsail
[community.aws.lightsail_static_ip](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.lightsail_static_ip_module.rst)|Manage static IP addresses in AWS Lightsail
[community.aws.networkfirewall](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.networkfirewall_module.rst)|manage AWS Network Firewall firewalls
[community.aws.networkfirewall_info](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.networkfirewall_info_module.rst)|describe AWS Network Firewall firewalls
[community.aws.networkfirewall_policy](https://github.com/ansible-collections/community.aws/blob/stable-4/docs/community.aws.networkfirewall_policy_module.rst)|manage AWS Network Firewall policies
......
......@@ -2407,3 +2407,132 @@ releases:
name: rds_cluster_snapshot
namespace: ''
release_date: '2022-06-23'
4.1.0:
changes:
bugfixes:
- aws_api_gateway_domain - added the ``aws_api_gateway_domain`` module to the
aws module_defaults group (https://github.com/ansible-collections/community.aws/pull/1283).
- aws_config_aggregator - Fix `KeyError` when updating existing aggregator (https://github.com/ansible-collections/community.aws/pull/645).
- aws_config_aggregator - Fix idempotency when ``account_sources`` parameter
is not specified (https://github.com/ansible-collections/community.aws/pull/645).
- aws_ssm - pull S3 bucket region for session generated for file transfer during
playbooks (https://github.com/ansible-collections/community.aws/issues/1190).
- aws_ssm_parameter_store - fixed bug where module wasn't consistently idempotent
(https://github.com/ansible-collections/community.aws/pull/1309).
- cloudfront_response_headers_policy - added the ``cloudfront_response_headers_policy``
module to the aws module_defaults group (https://github.com/ansible-collections/community.aws/pull/1283).
- ec2_vpc_peer - fix idempotency when requester/accepter is reversed (https://github.com/ansible-collections/community.aws/issues/580).
- kms_key_info - handle access denied errors more liberally (https://github.com/ansible-collections/community.aws/issues/206).
- route53 - fixes bug preventing creating a DNS record with a weight of zero
(https://github.com/ansible-collections/community.aws/issues/1378)
- route53_info - fix ``max_items`` parameter when used with non-paginated commands
(https://github.com/ansible-collections/community.aws/issues/1383).
- sns_topic - fix bug which prevented the module being used in GovCloud (https://github.com/ansible-collections/community.aws/issues/836).
deprecated_features:
- aws_glue_connection - the ``connection_parameters`` return key has been deprecated
and will be removed in a release after 2024-06-01, it is being replaced by
the ``raw_connection_parameters`` key (https://github.com/ansible-collections/community.aws/pull/518).
- community.aws collection - due to the AWS SDKs announcing the end of support
for Python less than 3.7 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/)
support for Python less than 3.7 by this collection has been deprecated and
will be removed in a release after 2023-05-31 (https://github.com/ansible-collections/community.aws/pull/1361).
- iam_policy - the ``policies`` return value has been renamed ``policy_names``
and will be removed in a release after 2024-08-01, both values are currently
returned (https://github.com/ansible-collections/community.aws/pull/1375).
- lambda_info - The ``function`` return key returns a dictionary of dictionaries
and has been deprecated. In a release after 2025-01-01, this key will be removed
in favor of ``functions``, which returns a list of dictionaries (https://github.com/ansible-collections/community.aws/pull/1239).
- route53_info - The CamelCase return values for ```DelegationSets```, ```CheckerIpRanges```,
and ```HealthCheck``` have been deprecated, in the future release you must
use snake_case return values ```delegation_sets```, ```checker_ip_ranges```,
and ```health_check``` instead respectively" (https://github.com/ansible-collections/community.aws/pull/1322).
minor_changes:
- aws_glue_connection - added new ``raw_connection_parameters`` return key which
doesn't snake case the connection parameters (https://github.com/ansible-collections/community.aws/pull/518).
- aws_ssm_parameter_store - added support for check_mode (https://github.com/ansible-collections/community.aws/pull/1309).
- cloudwatchevent_rule - Added ``targets.input_transformer.input_paths_map``
and ``targets.input_transformer.input_template`` parameters to support configuring
on CloudWatch event rule input transformation (https://github.com/ansible-collections/community.aws/pull/623).
- cloudwatchevent_rule - Applied validation of ``targets`` arguments (https://github.com/ansible-collections/community.aws/issues/201).
- cloudwatchlogs_log_group - Added check_mode support (https://github.com/ansible-collections/community.aws/pull/1373).
- ec2_launch_template - Adds support for specifying the ``source_version`` upon
which template updates are based (https://github.com/ansible-collections/community.aws/pull/239).
- ec2_scaling_policy - add TargetTrackingScaling as a scaling policy option
(https://github.com/ansible-collections/community.aws/pull/771)
- ec2_vpc_vgw_info - updated to not throw an error when run in check_mode (https://github.com/ansible-collections/community.aws/issues/137).
- ecs_ecr - add `force_absent` parameter for removing repositories that contain
images (https://github.com/ansible-collections/community.aws/pull/1316).
- ecs_service - add ``wait`` parameter and waiter for deleting services (https://github.com/ansible-collections/community.aws/pull/1209).
- ecs_service - added ``tags`` and ``tag_propagation`` support to the module
(https://github.com/ansible-collections/community.aws/pull/543).
- ecs_service - added parameter ``deployment_controller`` so service can be
controlled by Code Deploy (https://github.com/ansible-collections/community.aws/pull/340).
- ecs_task - add ``wait`` parameter and waiter for running and stopping tasks
(https://github.com/ansible-collections/community.aws/pull/1209).
- elasticache_info - added ``replication_group`` to the returned information
for an elasticache cluster (https://github.com/ansible-collections/community.aws/pull/646).
- iam_policy - added support for ``--diff`` mode (https://github.com/ansible-collections/community.aws/issues/560).
- iam_policy - attempts to continue when read requests are denied by IAM policy
(https://github.com/ansible-collections/community.aws/pull/1375).
- iam_server_certificate - the deprecation for the ``iam_cert`` alias has been
extended from release 4.0.0 to release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/1257).
- iam_server_certificate - the deprecations for ``cert_chain``, ``cert``, ``key``
and ``dup_ok`` have been extended from release 4.0.0 to release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/1256).
- lambda_info - add return key ``functions`` which returns a list of dictionaries
instead of the previously returned ``function``, which returned a dictionary
of dictionaries (https://github.com/ansible-collections/community.aws/pull/1239).
- lambda_info - now returns basic configuration information of each lambda function,
regardless of query (https://github.com/ansible-collections/community.aws/pull/1239).
- rds_instance_snapshot - the deprecation for the ``rds_snapshot`` alias has
been extended from release 4.0.0 to release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/1257).
- route53_health_check - Added new parameter ``health_check_id`` with alias
``id`` to allow update and delete health check by ID (https://github.com/ansible-collections/community.aws/pull/1143).
- route53_health_check - Added new parameter ``use_unique_names`` used with
new parameter ``health_check_name`` with alias ``name`` to set health check
name as unique identifier (https://github.com/ansible-collections/community.aws/pull/1143).
- s3_sync - improves error handling during ``HEAD`` operation to compare existing
files (https://github.com/ansible-collections/community.aws/issues/58).
- secretsmanager_secret - add support for storing JSON in secrets (https://github.com/ansible-collections/community.aws/issues/656).
- sns_topic - Added ``attributes`` parameter to ``subscriptions`` items with
support for RawMessageDelievery (SQS)
fragments:
- 1143-route53_health_check-update-delete-by-id-and-name.yml
- 1176-ssm-connection-plugin-region-fix.yml
- 1195-sns_topic.yml
- 1209-ecs_service-add-waiters.yml
- 1239-lambda_info-return_list.yml
- 1257-deprecations.yml
- 1282-meta.yml
- 1308-ssm_parameter-check_mode.yml
- 1315-ecs_ecr-force_absent.yaml
- 1322-route53_info-add-snake_case-return-values.yml
- 137-ec2_vpc_vgw_info.yml
- 1373-cloudwatchlogs_log_group-add-check_mode-support.yml
- 1379-zero_weight_dns_fix.yml
- 1384-route53_info-fix-max-items.yml
- 206-kms_key_info.yml
- 239-launch_template-source-version.yml
- 340-deployment-controller.yml
- 518-aws_glue_connection-do-not-lowercase-connection-parameters.yml
- 543-ecs_propagate_tags_support.yml
- 544-add-targettracking-scaling-policy.yml
- 560-iam_policy-diff.yml
- 58-s3_sync.yml
- 580-vpc_peer-idempotency.yml
- 623-cloudwatchevents_rule-support_input_transformer.yml
- 640-sns_topic-sub_attr.yml
- 645-aws_config_aggregator-fix-update-and-idempotency.yml
- 646-elasticache_info-replication_group.yml
- 656-secrets-json.yml
- python.yml
modules:
- description: Completes the lifecycle action of an instance
name: autoscaling_complete_lifecycle_action
namespace: ''
- description: Manage an AWS Glue crawler
name: aws_glue_crawler
namespace: ''
- description: Manage static IP addresses in AWS Lightsail
name: lightsail_static_ip
namespace: ''
release_date: '2022-08-03'
minor_changes:
- route53_health_check - Added new parameter ``health_check_id`` with alias ``id`` to allow update and delete health check by ID (https://github.com/ansible-collections/community.aws/pull/1143).
- route53_health_check - Added new parameter ``use_unique_names`` used with new parameter ``health_check_name`` with alias ``name`` to set health check name as unique identifier (https://github.com/ansible-collections/community.aws/pull/1143).
bugfixes:
- aws_ssm - pull S3 bucket region for session generated for file transfer during playbooks (https://github.com/ansible-collections/community.aws/issues/1190).
bugfixes:
- sns_topic - fix bug which prevented the module being used in GovCloud (https://github.com/ansible-collections/community.aws/issues/836).
minor_changes:
- ecs_service - add ``wait`` parameter and waiter for deleting services (https://github.com/ansible-collections/community.aws/pull/1209).
- ecs_task - add ``wait`` parameter and waiter for running and stopping tasks (https://github.com/ansible-collections/community.aws/pull/1209).
minor_changes:
- lambda_info - add return key ``functions`` which returns a list of dictionaries instead of the previously returned
``function``, which returned a dictionary of dictionaries (https://github.com/ansible-collections/community.aws/pull/1239).
- lambda_info - now returns basic configuration information of each lambda function, regardless of query (https://github.com/ansible-collections/community.aws/pull/1239).
deprecated_features:
- lambda_info - The ``function`` return key returns a dictionary of dictionaries and has been deprecated. In a release after 2025-01-01, this key will
be removed in favor of ``functions``, which returns a list of dictionaries (https://github.com/ansible-collections/community.aws/pull/1239).
minor_changes:
- iam_server_certificate - the deprecations for ``cert_chain``, ``cert``, ``key`` and ``dup_ok`` have been extended from release 4.0.0 to release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/1256).
- iam_server_certificate - the deprecation for the ``iam_cert`` alias has been extended from release 4.0.0 to release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/1257).
- rds_instance_snapshot - the deprecation for the ``rds_snapshot`` alias has been extended from release 4.0.0 to release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/1257).
bugfixes:
- aws_api_gateway_domain - added the ``aws_api_gateway_domain`` module to the aws module_defaults group (https://github.com/ansible-collections/community.aws/pull/1283).
- cloudfront_response_headers_policy - added the ``cloudfront_response_headers_policy`` module to the aws module_defaults group (https://github.com/ansible-collections/community.aws/pull/1283).
minor_changes:
- aws_ssm_parameter_store - added support for check_mode (https://github.com/ansible-collections/community.aws/pull/1309).
bugfixes:
- aws_ssm_parameter_store - fixed bug where module wasn't consistently idempotent (https://github.com/ansible-collections/community.aws/pull/1309).
minor_changes:
- ecs_ecr - add `force_absent` parameter for removing repositories that contain images (https://github.com/ansible-collections/community.aws/pull/1316).
\ No newline at end of file
deprecated_features:
- route53_info - The CamelCase return values for ```DelegationSets```, ```CheckerIpRanges```, and ```HealthCheck```
have been deprecated, in the future release you must use snake_case return values ```delegation_sets```, ```checker_ip_ranges```,
and ```health_check``` instead respectively" (https://github.com/ansible-collections/community.aws/pull/1322).
minor_changes:
- ec2_vpc_vgw_info - updated to not throw an error when run in check_mode (https://github.com/ansible-collections/community.aws/issues/137).
minor_changes:
- cloudwatchlogs_log_group - Added check_mode support (https://github.com/ansible-collections/community.aws/pull/1373).
\ No newline at end of file
bugfixes:
- route53 - fixes bug preventing creating a DNS record with a weight of zero (https://github.com/ansible-collections/community.aws/issues/1378)
\ No newline at end of file
bugfixes:
- route53_info - fix ``max_items`` parameter when used with non-paginated commands (https://github.com/ansible-collections/community.aws/issues/1383).
bugfixes:
- kms_key_info - handle access denied errors more liberally (https://github.com/ansible-collections/community.aws/issues/206).
minor_changes:
- ec2_launch_template - Adds support for specifying the ``source_version`` upon which template updates are based (https://github.com/ansible-collections/community.aws/pull/239).
minor_changes:
- ecs_service - added parameter ``deployment_controller`` so service can be controlled by Code Deploy (https://github.com/ansible-collections/community.aws/pull/340).
minor_changes:
- aws_glue_connection - added new ``raw_connection_parameters`` return key which doesn't snake case the connection parameters (https://github.com/ansible-collections/community.aws/pull/518).
deprecated_features:
- aws_glue_connection - the ``connection_parameters`` return key has been deprecated and will be removed in a release after 2024-06-01, it is being replaced by the ``raw_connection_parameters`` key (https://github.com/ansible-collections/community.aws/pull/518).
---
minor_changes:
- ecs_service - added ``tags`` and ``tag_propagation`` support to the module (https://github.com/ansible-collections/community.aws/pull/543).
minor_changes:
- ec2_scaling_policy - add TargetTrackingScaling as a scaling policy option (https://github.com/ansible-collections/community.aws/pull/771)
minor_changes:
- iam_policy - added support for ``--diff`` mode (https://github.com/ansible-collections/community.aws/issues/560).
- iam_policy - attempts to continue when read requests are denied by IAM policy (https://github.com/ansible-collections/community.aws/pull/1375).
deprecated_features:
- iam_policy - the ``policies`` return value has been renamed ``policy_names`` and will be removed in a release after 2024-08-01, both values are currently returned (https://github.com/ansible-collections/community.aws/pull/1375).
minor_changes:
- s3_sync - improves error handling during ``HEAD`` operation to compare existing files (https://github.com/ansible-collections/community.aws/issues/58).
bugfixes:
- ec2_vpc_peer - fix idempotency when requester/accepter is reversed (https://github.com/ansible-collections/community.aws/issues/580).
minor_changes:
- cloudwatchevent_rule - Added ``targets.input_transformer.input_paths_map`` and ``targets.input_transformer.input_template`` parameters to
support configuring on CloudWatch event rule input transformation (https://github.com/ansible-collections/community.aws/pull/623).
- cloudwatchevent_rule - Applied validation of ``targets`` arguments (https://github.com/ansible-collections/community.aws/issues/201).
minor_changes:
- sns_topic - Added ``attributes`` parameter to ``subscriptions`` items with support for RawMessageDelievery (SQS)
bugfixes:
- aws_config_aggregator - Fix idempotency when ``account_sources`` parameter is not specified (https://github.com/ansible-collections/community.aws/pull/645).
- aws_config_aggregator - Fix `KeyError` when updating existing aggregator (https://github.com/ansible-collections/community.aws/pull/645).
minor_changes:
- elasticache_info - added ``replication_group`` to the returned information for an elasticache cluster (https://github.com/ansible-collections/community.aws/pull/646).
minor_changes:
- secretsmanager_secret - add support for storing JSON in secrets (https://github.com/ansible-collections/community.aws/issues/656).
deprecated_features:
- community.aws collection - due to the AWS SDKs announcing the end of support for Python less than 3.7
(https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/)
support for Python less than 3.7 by this collection has been deprecated and will be removed in a
release after 2023-05-31
(https://github.com/ansible-collections/community.aws/pull/1361).
.. _community.aws.autoscaling_complete_lifecycle_action_module:
***************************************************
community.aws.autoscaling_complete_lifecycle_action
***************************************************
**Completes the lifecycle action of an instance**
Version added: 4.1.0
.. contents::
:local:
:depth: 1
Synopsis
--------
- Used to complete the lifecycle action for the specified instance with the specified result.
Requirements
------------
The below requirements are needed on the host that executes this module.
- python >= 3.6
- boto3 >= 1.17.0
- botocore >= 1.20.0
Parameters
----------
.. raw:: html
<table border=0 cellpadding=0 class="documentation-table">
<tr>
<th colspan="1">Parameter</th>
<th>Choices/<font color="blue">Defaults</font></th>
<th width="100%">Comments</th>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>asg_name</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
/ <span style="color: red">required</span>
</div>
</td>
<td>
</td>
<td>
<div>The name of the Auto Scaling Group which the instance belongs to.</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>aws_access_key</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
</div>
</td>
<td>
</td>
<td>
<div><code>AWS access key</code>. If not set then the value of the <code>AWS_ACCESS_KEY_ID</code>, <code>AWS_ACCESS_KEY</code> or <code>EC2_ACCESS_KEY</code> environment variable is used.</div>
<div>The <em>aws_access_key</em> and <em>profile</em> options are mutually exclusive.</div>
<div style="font-size: small; color: darkgreen"><br/>aliases: ec2_access_key, access_key</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>aws_ca_bundle</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">path</span>
</div>
</td>
<td>
</td>
<td>
<div>The location of a CA Bundle to use when validating SSL certificates.</div>
<div>Note: The CA Bundle is read &#x27;module&#x27; side and may need to be explicitly copied from the controller if not run locally.</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>aws_config</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">dictionary</span>
</div>
</td>
<td>
</td>
<td>
<div>A dictionary to modify the botocore configuration.</div>
<div>Parameters can be found at <a href='https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config'>https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config</a>.</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>aws_secret_key</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
</div>
</td>
<td>
</td>
<td>
<div><code>AWS secret key</code>. If not set then the value of the <code>AWS_SECRET_ACCESS_KEY</code>, <code>AWS_SECRET_KEY</code>, or <code>EC2_SECRET_KEY</code> environment variable is used.</div>
<div>The <em>aws_secret_key</em> and <em>profile</em> options are mutually exclusive.</div>
<div style="font-size: small; color: darkgreen"><br/>aliases: ec2_secret_key, secret_key</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>debug_botocore_endpoint_logs</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">boolean</span>
</div>
</td>
<td>
<ul style="margin: 0; padding: 0"><b>Choices:</b>
<li><div style="color: blue"><b>no</b>&nbsp;&larr;</div></li>
<li>yes</li>
</ul>
</td>
<td>
<div>Use a botocore.endpoint logger to parse the unique (rather than total) &quot;resource:action&quot; API calls made during a task, outputing the set to the resource_actions key in the task results. Use the aws_resource_action callback to output to total list made during a playbook. The ANSIBLE_DEBUG_BOTOCORE_LOGS environment variable may also be used.</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>ec2_url</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
</div>
</td>
<td>
</td>
<td>
<div>URL to use to connect to EC2 or your Eucalyptus cloud (by default the module will use EC2 endpoints). Ignored for modules where region is required. Must be specified for all other modules if region is not used. If not set then the value of the EC2_URL environment variable, if any, is used.</div>
<div style="font-size: small; color: darkgreen"><br/>aliases: aws_endpoint_url, endpoint_url</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>instance_id</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
/ <span style="color: red">required</span>
</div>
</td>
<td>
</td>
<td>
<div>The ID of the instance.</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>lifecycle_action_result</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
/ <span style="color: red">required</span>
</div>
</td>
<td>
<ul style="margin: 0; padding: 0"><b>Choices:</b>
<li>CONTINUE</li>
<li>ABANDON</li>
</ul>
</td>
<td>
<div>The action for the lifecycle hook to take.</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>lifecycle_hook_name</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
/ <span style="color: red">required</span>
</div>
</td>
<td>
</td>
<td>
<div>The name of the lifecycle hook to complete.</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>profile</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
</div>
</td>
<td>
</td>
<td>
<div>The <em>profile</em> option is mutually exclusive with the <em>aws_access_key</em>, <em>aws_secret_key</em> and <em>security_token</em> options.</div>
<div style="font-size: small; color: darkgreen"><br/>aliases: aws_profile</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>region</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
</div>
</td>
<td>
</td>
<td>
<div>The AWS region to use. If not specified then the value of the AWS_REGION or EC2_REGION environment variable, if any, is used. See <a href='http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region'>http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region</a></div>
<div style="font-size: small; color: darkgreen"><br/>aliases: aws_region, ec2_region</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>security_token</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
</div>
</td>
<td>
</td>
<td>
<div><code>AWS STS security token</code>. If not set then the value of the <code>AWS_SECURITY_TOKEN</code> or <code>EC2_SECURITY_TOKEN</code> environment variable is used.</div>
<div>The <em>security_token</em> and <em>profile</em> options are mutually exclusive.</div>
<div>Aliases <em>aws_session_token</em> and <em>session_token</em> have been added in version 3.2.0.</div>
<div style="font-size: small; color: darkgreen"><br/>aliases: aws_session_token, session_token, aws_security_token, access_token</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>validate_certs</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">boolean</span>
</div>
</td>
<td>
<ul style="margin: 0; padding: 0"><b>Choices:</b>
<li>no</li>
<li><div style="color: blue"><b>yes</b>&nbsp;&larr;</div></li>
</ul>
</td>
<td>
<div>When set to &quot;no&quot;, SSL certificates will not be validated for communication with the AWS APIs.</div>
</td>
</tr>
</table>
<br/>
Notes
-----
.. note::
- If parameters are not set within the module, the following environment variables can be used in decreasing order of precedence ``AWS_URL`` or ``EC2_URL``, ``AWS_PROFILE`` or ``AWS_DEFAULT_PROFILE``, ``AWS_ACCESS_KEY_ID`` or ``AWS_ACCESS_KEY`` or ``EC2_ACCESS_KEY``, ``AWS_SECRET_ACCESS_KEY`` or ``AWS_SECRET_KEY`` or ``EC2_SECRET_KEY``, ``AWS_SECURITY_TOKEN`` or ``EC2_SECURITY_TOKEN``, ``AWS_REGION`` or ``EC2_REGION``, ``AWS_CA_BUNDLE``
- When no credentials are explicitly provided the AWS SDK (boto3) that Ansible uses will fall back to its configuration files (typically ``~/.aws/credentials``). See https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html for more information.
- ``AWS_REGION`` or ``EC2_REGION`` can be typically be used to specify the AWS region, when required, but this can also be defined in the configuration files.
Examples
--------
.. code-block:: yaml
# Note: These examples do not set authentication details, see the AWS Guide for details.
# Complete the lifecycle action
- aws_asg_complete_lifecycle_action:
asg_name: my-auto-scaling-group
lifecycle_hook_name: my-lifecycle-hook
lifecycle_action_result: CONTINUE
instance_id: i-123knm1l2312
Return Values
-------------
Common return values are documented `here <https://docs.ansible.com/ansible/latest/reference_appendices/common_return_values.html#common-return-values>`_, the following are the fields unique to this module:
.. raw:: html
<table border=0 cellpadding=0 class="documentation-table">
<tr>
<th colspan="1">Key</th>
<th>Returned</th>
<th width="100%">Description</th>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="return-"></div>
<b>status</b>
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
</div>
</td>
<td>success</td>
<td>
<div>How things went</div>
<br/>
<div style="font-size: smaller"><b>Sample:</b></div>
<div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">[&#x27;OK&#x27;]</div>
</td>
</tr>
</table>
<br/><br/>
Status
------
Authors
~~~~~~~
- Saleh Abbas (@salehabbas) <saleh.abbas@thetradedesk.com>
......@@ -455,10 +455,11 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late
</td>
<td>when state is present</td>
<td>
<div>A dict of key-value pairs used as parameters for this connection.</div>
<div>(deprecated) A dict of key-value pairs (converted to lowercase) used as parameters for this connection.</div>
<div>This return key has been deprecated, and will be removed in a release after 2024-06-01.</div>
<br/>
<div style="font-size: smaller"><b>Sample:</b></div>
<div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">{&#x27;JDBC_CONNECTION_URL&#x27;: &#x27;jdbc:mysql://mydb:3306/databasename&#x27;, &#x27;USERNAME&#x27;: &#x27;x&#x27;, &#x27;PASSWORD&#x27;: &#x27;y&#x27;}</div>
<div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">{&#x27;jdbc_connection_url&#x27;: &#x27;jdbc:mysql://mydb:3306/databasename&#x27;, &#x27;username&#x27;: &#x27;x&#x27;, &#x27;password&#x27;: &#x27;y&#x27;}</div>
</td>
</tr>
<tr>
......@@ -578,6 +579,23 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late
<div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">{&#x27;subnet-id&#x27;: &#x27;subnet-aabbccddee&#x27;}</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="return-"></div>
<b>raw_connection_properties</b>
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
<div style="font-size: small">
<span style="color: purple">dictionary</span>
</div>
</td>
<td>when state is present</td>
<td>
<div>A dict of key-value pairs used as parameters for this connection.</div>
<br/>
<div style="font-size: smaller"><b>Sample:</b></div>
<div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">{&#x27;JDBC_CONNECTION_URL&#x27;: &#x27;jdbc:mysql://mydb:3306/databasename&#x27;, &#x27;USERNAME&#x27;: &#x27;x&#x27;, &#x27;PASSWORD&#x27;: &#x27;y&#x27;}</div>
</td>
</tr>
</table>
<br/><br/>
......
此差异已折叠。
......@@ -157,6 +157,23 @@ Parameters
<div style="font-size: small; color: darkgreen"><br/>aliases: aws_endpoint_url, endpoint_url</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>json_secret</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">json</span>
</div>
<div style="font-style: italic; font-size: small; color: darkgreen">added in 4.1.0</div>
</td>
<td>
</td>
<td>
<div>Specifies JSON-formatted data that you want to encrypt and store in the new version of the secret.</div>
<div>Mutually exclusive with the <em>secret</em> option.</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
......@@ -320,6 +337,7 @@ Parameters
</td>
<td>
<div>Specifies string or binary data that you want to encrypt and store in the new version of the secret.</div>
<div>Mutually exclusive with the <em>json_secret</em> option.</div>
</td>
</tr>
<tr>
......
......@@ -18,7 +18,6 @@ Version added: 1.0.0
Synopsis
--------
- Manage key-value pairs in AWS SSM parameter store.
- To retreive SSM parameters use the :ref:`amazon.aws.aws_ssm_parameter <amazon.aws.aws_ssm_parameter_module>` lookup plugin.
......@@ -389,6 +388,14 @@ Notes
- ``AWS_REGION`` or ``EC2_REGION`` can be typically be used to specify the AWS region, when required, but this can also be defined in the configuration files.
See Also
--------
.. seealso::
:ref:`amazon.aws.aws_ssm lookup <ansible_collections.amazon.aws.aws_ssm_lookup>`
The documentation for the ``amazon.aws.aws_ssm`` lookup plugin.
Examples
--------
......
......@@ -163,13 +163,13 @@ Parameters
<b>event_pattern</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
<span style="color: purple">json</span>
</div>
</td>
<td>
</td>
<td>
<div>A string pattern (in valid JSON format) that is used to match against incoming events to determine if the rule should be triggered.</div>
<div>A string pattern that is used to match against incoming events to determine if the rule should be triggered.</div>
</td>
</tr>
<tr>
......@@ -363,6 +363,7 @@ Parameters
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
/ <span style="color: red">required</span>
</div>
</td>
<td>
......@@ -396,14 +397,14 @@ Parameters
<b>input</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
<span style="color: purple">json</span>
</div>
</td>
<td>
</td>
<td>
<div>A JSON object that will override the event data when passed to the target.</div>
<div>If neither <em>input</em> nor <em>input_path</em> is specified, then the entire event is passed to the target in JSON form.</div>
<div>A JSON object that will override the event data passed to the target.</div>
<div>If neither <em>input</em> nor <em>input_path</em> nor <em>input_transformer</em> is specified, then the entire event is passed to the target in JSON form.</div>
</td>
</tr>
<tr>
......@@ -420,9 +421,61 @@ Parameters
</td>
<td>
<div>A JSONPath string (e.g. <code>$.detail</code>) that specifies the part of the event data to be passed to the target.</div>
<div>If neither <em>input</em> nor <em>input_path</em> is specified, then the entire event is passed to the target in JSON form.</div>
<div>If neither <em>input</em> nor <em>input_path</em> nor <em>input_transformer</em> is specified, then the entire event is passed to the target in JSON form.</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td colspan="2">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>input_transformer</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">dictionary</span>
</div>
<div style="font-style: italic; font-size: small; color: darkgreen">added in 4.1.0</div>
</td>
<td>
</td>
<td>
<div>Settings to support providing custom input to a target based on certain event data.</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td class="elbow-placeholder"></td>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>input_paths_map</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">dictionary</span>
</div>
</td>
<td>
</td>
<td>
<div>A dict that specifies the transformation of the event data to custom input parameters.</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td class="elbow-placeholder"></td>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>input_template</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">json</span>
</div>
</td>
<td>
</td>
<td>
<div>A string that templates the values input_paths_map extracted from the event data. It is used to produce the output you want to be sent to the target.</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td colspan="2">
......@@ -468,7 +521,7 @@ Notes
.. note::
- A rule must contain at least an *event_pattern* or *schedule_expression*. A rule can have both an *event_pattern* and a *schedule_expression*, in which case the rule will trigger on matching events as well as on a schedule.
- When specifying targets, *input* and *input_path* are mutually-exclusive and optional parameters.
- When specifying targets, *input*, *input_path*, *input_paths_map* and *input_template* are mutually-exclusive and optional parameters.
- If parameters are not set within the module, the following environment variables can be used in decreasing order of precedence ``AWS_URL`` or ``EC2_URL``, ``AWS_PROFILE`` or ``AWS_DEFAULT_PROFILE``, ``AWS_ACCESS_KEY_ID`` or ``AWS_ACCESS_KEY`` or ``EC2_ACCESS_KEY``, ``AWS_SECRET_ACCESS_KEY`` or ``AWS_SECRET_KEY`` or ``EC2_SECRET_KEY``, ``AWS_SECURITY_TOKEN`` or ``EC2_SECURITY_TOKEN``, ``AWS_REGION`` or ``EC2_REGION``, ``AWS_CA_BUNDLE``
- When no credentials are explicitly provided the AWS SDK (boto3) that Ansible uses will fall back to its configuration files (typically ``~/.aws/credentials``). See https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html for more information.
- ``AWS_REGION`` or ``EC2_REGION`` can be typically be used to specify the AWS region, when required, but this can also be defined in the configuration files.
......@@ -498,6 +551,20 @@ Examples
arn: arn:aws:lambda:us-east-1:123456789012:function:MyFunction
input: '{"foo": "bar"}'
- community.aws.cloudwatchevent_rule:
name: MyInstanceLaunchEvent
description: "Rule for EC2 instance launch"
state: present
event_pattern: '{"source":["aws.ec2"],"detail-type":["EC2 Instance State-change Notification"],"detail":{"state":["pending"]}}'
targets:
- id: MyTargetSnsTopic
arn: arn:aws:sns:us-east-1:123456789012:MySNSTopic
input_transformer:
input_paths_map:
instance: "$.detail.instance-id"
state: "$.detail.state"
input_template: "<instance> is in state <state>"
- community.aws.cloudwatchevent_rule:
name: MyCronTask
state: absent
......
......@@ -1277,6 +1277,23 @@ Parameters
<div style="font-size: small; color: darkgreen"><br/>aliases: aws_session_token, session_token, aws_security_token, access_token</div>
</td>
</tr>
<tr>
<td colspan="3">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>source_version</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
</div>
<div style="font-style: italic; font-size: small; color: darkgreen">added in 4.1.0</div>
</td>
<td>
<b>Default:</b><br/><div style="color: blue">"latest"</div>
</td>
<td>
<div>The version number of the launch template version on which to base the new version. The new version inherits the same launch parameters as the source version, except for parameters that you explicity specify. Snapshots applied to the block device mapping are ignored when creating a new version unless they are explicitly included.</div>
</td>
</tr>
<tr>
<td colspan="3">
<div class="ansibleOptionAnchor" id="parameter-"></div>
......
......@@ -17,7 +17,7 @@ Version added: 1.0.0
Synopsis
--------
- Gather information about virtual gateways in AWS.
- Gather information about virtual gateways (VGWs) in AWS.
......@@ -239,7 +239,7 @@ Parameters
<td>
</td>
<td>
<div>Get details of a specific Virtual Gateway ID. This value should be provided as a list.</div>
<div>Get details of a specific Virtual Gateway ID.</div>
</td>
</tr>
</table>
......
......@@ -142,6 +142,26 @@ Parameters
<div style="font-size: small; color: darkgreen"><br/>aliases: aws_endpoint_url, endpoint_url</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>force_absent</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">boolean</span>
</div>
<div style="font-style: italic; font-size: small; color: darkgreen">added in 4.1.0</div>
</td>
<td>
<ul style="margin: 0; padding: 0"><b>Choices:</b>
<li><div style="color: blue"><b>no</b>&nbsp;&larr;</div></li>
<li>yes</li>
</ul>
</td>
<td>
<div>If <em>force_absent=true</em>, the repository will be removed, even if images are present.</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
......
......@@ -17,7 +17,7 @@ Version added: 1.0.0
Synopsis
--------
- Creates or terminates ECS. services.
- Creates or terminates ECS services.
......@@ -348,6 +348,44 @@ Parameters
</td>
</tr>
<tr>
<td colspan="3">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>deployment_controller</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">dictionary</span>
</div>
<div style="font-style: italic; font-size: small; color: darkgreen">added in 4.1.0</div>
</td>
<td>
</td>
<td>
<div>The deployment controller to use for the service. If no deploymenet controller is specified, the ECS controller is used.</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td colspan="2">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>type</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
</div>
</td>
<td>
<ul style="margin: 0; padding: 0"><b>Choices:</b>
<li>ECS</li>
<li>CODE_DEPLOY</li>
<li>EXTERNAL</li>
</ul>
</td>
<td>
<div>The deployment controller type to use.</div>
</td>
</tr>
<tr>
<td colspan="3">
<div class="ansibleOptionAnchor" id="parameter-"></div>
......@@ -467,6 +505,8 @@ Parameters
</td>
<td>
<div>The list of ELBs defined for this service.</div>
<div>Load balancers for an existing service cannot be updated, and it is an error to do so.</div>
<div>When the deployment controller is CODE_DEPLOY changes to this value are simply ignored, and do not cause an error.</div>
</td>
</tr>
<tr>
......@@ -688,6 +728,26 @@ Parameters
<div style="font-size: small; color: darkgreen"><br/>aliases: aws_profile</div>
</td>
</tr>
<tr>
<td colspan="3">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>propagate_tags</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
</div>
<div style="font-style: italic; font-size: small; color: darkgreen">added in 4.1.0</div>
</td>
<td>
<ul style="margin: 0; padding: 0"><b>Choices:</b>
<li>TASK_DEFINITION</li>
<li>SERVICE</li>
</ul>
</td>
<td>
<div>Propagate tags from ECS task defintition or ECS service to ECS task.</div>
</td>
</tr>
<tr>
<td colspan="3">
<div class="ansibleOptionAnchor" id="parameter-"></div>
......@@ -860,6 +920,22 @@ Parameters
<div>The desired state of the service.</div>
</td>
</tr>
<tr>
<td colspan="3">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>tags</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">dictionary</span>
</div>
<div style="font-style: italic; font-size: small; color: darkgreen">added in 4.1.0</div>
</td>
<td>
</td>
<td>
<div>A dictionary of tags to add or remove from the resource.</div>
</td>
</tr>
<tr>
<td colspan="3">
<div class="ansibleOptionAnchor" id="parameter-"></div>
......@@ -874,6 +950,7 @@ Parameters
<td>
<div>The task definition the service will run.</div>
<div>This parameter is required when <em>state=present</em>.</div>
<div>This parameter is ignored when updating a service with a <code>CODE_DEPLOY</code> deployment controller in which case the task definition is managed by Code Pipeline and cannot be updated.</div>
</td>
</tr>
<tr>
......@@ -895,6 +972,27 @@ Parameters
<div>When set to &quot;no&quot;, SSL certificates will not be validated for communication with the AWS APIs.</div>
</td>
</tr>
<tr>
<td colspan="3">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>wait</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">boolean</span>
</div>
<div style="font-style: italic; font-size: small; color: darkgreen">added in 4.1.0</div>
</td>
<td>
<ul style="margin: 0; padding: 0"><b>Choices:</b>
<li><div style="color: blue"><b>no</b>&nbsp;&larr;</div></li>
<li>yes</li>
</ul>
</td>
<td>
<div>Whether or not to wait for the service to be inactive.</div>
<div>Waits only when <em>state</em> is <code>absent</code>.</div>
</td>
</tr>
</table>
<br/>
......@@ -918,7 +1016,6 @@ Examples
.. code-block:: yaml
# Note: These examples do not set authentication details, see the AWS Guide for details.
# Basic provisioning example
- community.aws.ecs_service:
state: present
......@@ -988,6 +1085,18 @@ Examples
weight: 1
base: 0
# With tags and tag propagation
- community.aws.ecs_service:
state: present
name: tags-test-service
cluster: new_cluster
task_definition: 'new_cluster-task:1'
desired_count: 1
tags:
Firstname: jane
lastName: doe
propagate_tags: SERVICE
Returned Facts
--------------
......@@ -996,7 +1105,7 @@ Facts returned by this module are added/updated in the ``hostvars`` host facts a
.. raw:: html
<table border=0 cellpadding=0 class="documentation-table">
<tr>
<tr>
<th colspan="4">Fact</th>
<th>Returned</th>
<th width="100%">Description</th>
......@@ -1397,6 +1506,23 @@ Facts returned by this module are added/updated in the ``hostvars`` host facts a
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td colspan="3" colspan="3">
<div class="ansibleOptionAnchor" id="return-"></div>
<b>propagateTags</b>
<a class="ansibleOptionLink" href="#return-" title="Permalink to this fact"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
</div>
</td>
<td>always</td>
<td>
<div>The type of tag propagation applied to the resource
</div>
<br/>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td colspan="3" colspan="3">
......@@ -1465,6 +1591,24 @@ Facts returned by this module are added/updated in the ``hostvars`` host facts a
<br/>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td colspan="3" colspan="3">
<div class="ansibleOptionAnchor" id="return-"></div>
<b>tags</b>
<a class="ansibleOptionLink" href="#return-" title="Permalink to this fact"></a>
<div style="font-size: small">
<span style="color: purple">list</span>
/ <span style="color: purple">elements=dictionary</span>
</div>
</td>
<td>when tags found</td>
<td>
<div>The tags applied to this resource.
</div>
<br/>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td colspan="3" colspan="3">
......@@ -1942,6 +2086,22 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late
</td>
</tr>
<tr>
<td class="elbow-placeholder">&nbsp;</td>
<td colspan="3">
<div class="ansibleOptionAnchor" id="return-"></div>
<b>propagateTags</b>
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
</div>
</td>
<td>always</td>
<td>
<div>The type of tag propagation applied to the resource.</div>
<br/>
</td>
</tr>
<tr>
<td class="elbow-placeholder">&nbsp;</td>
<td colspan="3">
......@@ -2006,6 +2166,22 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late
<br/>
</td>
</tr>
<tr>
<td class="elbow-placeholder">&nbsp;</td>
<td colspan="3">
<div class="ansibleOptionAnchor" id="return-"></div>
<b>tags</b>
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
<div style="font-size: small">
<span style="color: purple">dictionary</span>
</div>
</td>
<td>success</td>
<td>
<div>The tags applied to this resource.</div>
<br/>
</td>
</tr>
<tr>
<td class="elbow-placeholder">&nbsp;</td>
<td colspan="3">
......
......@@ -449,6 +449,26 @@ Parameters
<div>When set to &quot;no&quot;, SSL certificates will not be validated for communication with the AWS APIs.</div>
</td>
</tr>
<tr>
<td colspan="2">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>wait</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">boolean</span>
</div>
<div style="font-style: italic; font-size: small; color: darkgreen">added in 4.1.0</div>
</td>
<td>
<ul style="margin: 0; padding: 0"><b>Choices:</b>
<li><div style="color: blue"><b>no</b>&nbsp;&larr;</div></li>
<li>yes</li>
</ul>
</td>
<td>
<div>Whether or not to wait for the desired state.</div>
</td>
</tr>
</table>
<br/>
......
......@@ -440,6 +440,25 @@ Parameters
</td>
<td>
<div>The Amazon Resource Name (ARN) of the target group.</div>
<div>Mutually exclusive with <em>TargetGroupName</em>.</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td class="elbow-placeholder"></td>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>TargetGroupName</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">-</span>
</div>
</td>
<td>
</td>
<td>
<div>The name of the target group.</div>
<div>Mutually exclusive with <em>TargetGroupArn</em>.</div>
</td>
</tr>
<tr>
......
......@@ -285,6 +285,25 @@ Parameters
</td>
<td>
<div>The Amazon Resource Name (ARN) of the target group.</div>
<div>Mutually exclusive with <em>TargetGroupName</em>.</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td class="elbow-placeholder"></td>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>TargetGroupName</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">-</span>
</div>
</td>
<td>
</td>
<td>
<div>The name of the target group.</div>
<div>Mutually exclusive with <em>TargetGroupArn</em>.</div>
</td>
</tr>
<tr>
......
......@@ -211,7 +211,6 @@ Parameters
<td>
<div>A properly json formatted policy as string.</div>
<div>Mutually exclusive with <em>policy_document</em>.</div>
<div>See <a href='https://github.com/ansible/ansible/issues/7005#issuecomment-42894813'>https://github.com/ansible/ansible/issues/7005#issuecomment-42894813</a> on how to use it properly.</div>
</td>
</tr>
<tr>
......@@ -415,7 +414,7 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="return-"></div>
<b>policies</b>
<b>policy_names</b>
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
<div style="font-size: small">
<span style="color: purple">list</span>
......
......@@ -121,7 +121,7 @@ Parameters
<td>
<div>The path to, or content of the certificate body in PEM encoded format.</div>
<div>If the parameter is not a file, it is assumed to be content.</div>
<div>Passing a file name is deprecated, and support will be dropped in version 4.0.0 of this collection.</div>
<div>Passing a file name is deprecated, and support will be dropped in version 5.0.0 of this collection.</div>
</td>
</tr>
<tr>
......@@ -138,7 +138,7 @@ Parameters
<td>
<div>The path to, or content of, the CA certificate chain in PEM encoded format.</div>
<div>If the parameter is not a file, it is assumed to be content.</div>
<div>Passing a file name is deprecated, and support will be dropped in version 4.0.0 of this collection.</div>
<div>Passing a file name is deprecated, and support will be dropped in version 5.0.0 of this collection.</div>
</td>
</tr>
<tr>
......@@ -178,7 +178,7 @@ Parameters
<td>
<div>By default the module will not upload a certificate that is already uploaded into AWS.</div>
<div>If <em>dup_ok=True</em>, it will upload the certificate as long as the name is unique.</div>
<div>Currently defaults to <code>false</code>, this will default to <code>true</code> in release 4.0.0.</div>
<div>Currently defaults to <code>false</code>, this will default to <code>true</code> in release 5.0.0.</div>
</td>
</tr>
<tr>
......@@ -210,7 +210,7 @@ Parameters
</td>
<td>
<div>The path to, or content of the private key in PEM encoded format. If the parameter is not a file, it is assumed to be content.</div>
<div>Passing a file name is deprecated, and support will be dropped in version 4.0.0 of this collection.</div>
<div>Passing a file name is deprecated, and support will be dropped in version 5.0.0 of this collection.</div>
</td>
</tr>
<tr>
......
此差异已折叠。
......@@ -208,6 +208,42 @@ Parameters
<div>Domain name of the endpoint to check. Either this or <em>ip_address</em> has to be provided. When both are given the <em>fqdn</em> is used in the <code>Host:</code> header of the HTTP request.</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>health_check_id</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
</div>
<div style="font-style: italic; font-size: small; color: darkgreen">added in 4.1.0</div>
</td>
<td>
</td>
<td>
<div>ID of the health check to be update or deleted.</div>
<div>If provided, a health check can be updated or deleted based on the ID as unique identifier.</div>
<div style="font-size: small; color: darkgreen"><br/>aliases: id</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>health_check_name</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
</div>
<div style="font-style: italic; font-size: small; color: darkgreen">added in 4.1.0</div>
</td>
<td>
</td>
<td>
<div>Name of the Health Check.</div>
<div>Used together with <em>use_unique_names</em> to set/make use of <em>health_check_name</em> as a unique identifier.</div>
<div style="font-size: small; color: darkgreen"><br/>aliases: name</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
......@@ -406,7 +442,6 @@ Parameters
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">string</span>
/ <span style="color: red">required</span>
</div>
</td>
<td>
......@@ -420,6 +455,27 @@ Parameters
</td>
<td>
<div>The type of health check that you want to create, which indicates how Amazon Route 53 determines whether an endpoint is healthy.</div>
<div>Once health_check is created, type can not be changed.</div>
</td>
</tr>
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>use_unique_names</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">boolean</span>
</div>
<div style="font-style: italic; font-size: small; color: darkgreen">added in 4.1.0</div>
</td>
<td>
<ul style="margin: 0; padding: 0"><b>Choices:</b>
<li>no</li>
<li>yes</li>
</ul>
</td>
<td>
<div>Used together with <em>health_check_name</em> to set/make use of <em>health_check_name</em> as a unique identifier.</div>
</td>
</tr>
<tr>
......@@ -484,11 +540,35 @@ Examples
weight: 100
health_check: "{{ my_health_check.health_check.id }}"
- name: create a simple health check with health_check_name as unique identifier
community.aws.route53_health_check:
state: present
health_check_name: ansible
fqdn: ansible.com
port: 443
type: HTTPS
use_unique_names: true
- name: Delete health-check
community.aws.route53_health_check:
state: absent
fqdn: host1.example.com
- name: Update Health check by ID - update ip_address
community.aws.route53_health_check:
id: 12345678-abcd-abcd-abcd-0fxxxxxxxxxx
ip_address: 1.2.3.4
- name: Update Health check by ID - update port
community.aws.route53_health_check:
id: 12345678-abcd-abcd-abcd-0fxxxxxxxxxx
ip_address: 8080
- name: Delete Health check by ID
community.aws.route53_health_check:
state: absent
id: 12345678-abcd-abcd-abcd-0fxxxxxxxxxx
Return Values
......
......@@ -589,7 +589,7 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late
<tr>
<td colspan="1">
<div class="ansibleOptionAnchor" id="return-"></div>
<b>uploaded</b>
<b>uploads</b>
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
<div style="font-size: small">
<span style="color: purple">list</span>
......
......@@ -548,6 +548,24 @@ Parameters
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td colspan="3">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>attributes</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">-</span>
</div>
<div style="font-style: italic; font-size: small; color: darkgreen">added in 4.1.0</div>
</td>
<td>
<b>Default:</b><br/><div style="color: blue">{}</div>
</td>
<td>
<div>Attributes of subscription. Only supports RawMessageDelievery for SQS endpoints.</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td colspan="3">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>endpoint</b>
......@@ -598,7 +616,8 @@ Parameters
</ul>
</td>
<td>
<div>The type of topic that should be created. Either Standard for FIFO (first-in, first-out)</div>
<div>The type of topic that should be created. Either Standard for FIFO (first-in, first-out).</div>
<div>Some regions, including GovCloud regions do not support FIFO topics. Use a default value of &#x27;standard&#x27; or omit the option if the region does not support FIFO topics.</div>
</td>
</tr>
<tr>
......
namespace: community
name: aws
version: 4.0.0
version: 4.1.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: '>=4.0.0'
amazon.aws: '>=4.1.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
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册