From ca5ef924b9cf093f74b96e5e977cbb3427f79dee Mon Sep 17 00:00:00 2001 From: Markus Bergholz Date: Wed, 12 Jan 2022 12:33:20 +0100 Subject: [PATCH] Prepare for community.aws release 3.0.0 (#848) Prepare for community.aws release 3.0.0 SUMMARY next major release ISSUE TYPE Feature Pull Request COMPONENT NAME everything Reviewed-by: Alina Buzachis Reviewed-by: Mark Chappell Reviewed-by: Jill R Reviewed-by: None --- CHANGELOG.rst | 71 + README.md | 5 +- changelogs/changelog.yaml | 119 ++ .../fragments/14532-remove-deprecations.yml | 3 - .../480-aws_glue_job-python-glue-version.yml | 5 - ...-aws_ssm_connection-add-sse-parameters.yml | 2 - .../fragments/801-fix-delete-without-ttl.yml | 2 - changelogs/fragments/809-botocore-1-19-0.yml | 7 - .../813-route53_info-fix-max_items.yml | 2 - .../fragments/818-fix-eks-short-name.yml | 2 - .../822-add-password-support-iam_user.yml | 3 - ...ecated-dynamodb_table-updates-fail.yml.yml | 3 - ...8-ignore-deprecated-param-aws_kms_info.yml | 2 - .../fragments/remove_deprecated_facts.yml | 38 - docs/community.aws.aws_acm_info_module.rst | 5 +- docs/community.aws.aws_acm_module.rst | 4 +- docs/community.aws.aws_api_gateway_module.rst | 4 +- ....aws_application_scaling_policy_module.rst | 4 +- ...s.aws_batch_compute_environment_module.rst | 4 +- ...ty.aws.aws_batch_job_definition_module.rst | 4 +- ...mmunity.aws.aws_batch_job_queue_module.rst | 4 +- docs/community.aws.aws_codebuild_module.rst | 4 +- docs/community.aws.aws_codecommit_module.rst | 4 +- .../community.aws.aws_codepipeline_module.rst | 4 +- ...onfig_aggregation_authorization_module.rst | 4 +- ...unity.aws.aws_config_aggregator_module.rst | 4 +- ...aws.aws_config_delivery_channel_module.rst | 4 +- ...mmunity.aws.aws_config_recorder_module.rst | 4 +- docs/community.aws.aws_config_rule_module.rst | 4 +- ...rect_connect_confirm_connection_module.rst | 4 +- ...s.aws_direct_connect_connection_module.rst | 4 +- ....aws.aws_direct_connect_gateway_module.rst | 4 +- ..._connect_link_aggregation_group_module.rst | 4 +- ...irect_connect_virtual_interface_module.rst | 4 +- docs/community.aws.aws_eks_cluster_module.rst | 4 +- ...ty.aws.aws_elasticbeanstalk_app_module.rst | 4 +- ...mmunity.aws.aws_glue_connection_module.rst | 4 +- docs/community.aws.aws_glue_job_module.rst | 99 +- ...munity.aws.aws_inspector_target_module.rst | 4 +- docs/community.aws.aws_kms_info_module.rst | 5 +- docs/community.aws.aws_kms_module.rst | 4 +- docs/community.aws.aws_msk_cluster_module.rst | 4 +- docs/community.aws.aws_msk_config_module.rst | 4 +- docs/community.aws.aws_region_info_module.rst | 5 +- ...ommunity.aws.aws_s3_bucket_info_module.rst | 6 +- docs/community.aws.aws_s3_cors_module.rst | 4 +- docs/community.aws.aws_secret_module.rst | 4 +- .../community.aws.aws_ses_identity_module.rst | 4 +- ...ity.aws.aws_ses_identity_policy_module.rst | 4 +- .../community.aws.aws_ses_rule_set_module.rst | 4 +- docs/community.aws.aws_sgw_info_module.rst | 5 +- docs/community.aws.aws_ssm_connection.rst | 56 + ...ity.aws.aws_ssm_parameter_store_module.rst | 4 +- ...nctions_state_machine_execution_module.rst | 4 +- ...ws_step_functions_state_machine_module.rst | 4 +- ...community.aws.aws_waf_condition_module.rst | 4 +- docs/community.aws.aws_waf_info_module.rst | 5 +- docs/community.aws.aws_waf_rule_module.rst | 4 +- docs/community.aws.aws_waf_web_acl_module.rst | 4 +- ...aws.cloudformation_exports_info_module.rst | 4 +- ...ty.aws.cloudformation_stack_set_module.rst | 4 +- ...ity.aws.cloudfront_distribution_module.rst | 4 +- docs/community.aws.cloudfront_info_module.rst | 21 +- ...ity.aws.cloudfront_invalidation_module.rst | 4 +- ...oudfront_origin_access_identity_module.rst | 4 +- docs/community.aws.cloudtrail_module.rst | 4 +- ...munity.aws.cloudwatchevent_rule_module.rst | 4 +- ...s.cloudwatchlogs_log_group_info_module.rst | 5 +- ...tchlogs_log_group_metric_filter_module.rst | 4 +- ...ty.aws.cloudwatchlogs_log_group_module.rst | 4 +- docs/community.aws.data_pipeline_module.rst | 4 +- docs/community.aws.dms_endpoint_module.rst | 4 +- ...ws.dms_replication_subnet_group_module.rst | 4 +- docs/community.aws.dynamodb_table_module.rst | 4 +- docs/community.aws.dynamodb_ttl_module.rst | 4 +- docs/community.aws.ec2_ami_copy_module.rst | 4 +- docs/community.aws.ec2_asg_info_module.rst | 5 +- ...nity.aws.ec2_asg_lifecycle_hook_module.rst | 4 +- docs/community.aws.ec2_asg_module.rst | 4 +- ...y.aws.ec2_asg_scheduled_action_module.rst} | 400 ++-- ...y.aws.ec2_customer_gateway_info_module.rst | 5 +- ...munity.aws.ec2_customer_gateway_module.rst | 4 +- docs/community.aws.ec2_eip_info_module.rst | 5 +- docs/community.aws.ec2_eip_module.rst | 4 +- docs/community.aws.ec2_elb_info_module.rst | 308 --- ...mmunity.aws.ec2_launch_template_module.rst | 4 +- docs/community.aws.ec2_lc_find_module.rst | 4 +- docs/community.aws.ec2_lc_info_module.rst | 5 +- docs/community.aws.ec2_lc_module.rst | 4 +- .../community.aws.ec2_metric_alarm_module.rst | 4 +- ...ty.aws.ec2_placement_group_info_module.rst | 5 +- ...mmunity.aws.ec2_placement_group_module.rst | 4 +- ...ommunity.aws.ec2_scaling_policy_module.rst | 4 +- ...community.aws.ec2_snapshot_copy_module.rst | 4 +- ...ty.aws.ec2_transit_gateway_info_module.rst | 4 +- ...mmunity.aws.ec2_transit_gateway_module.rst | 4 +- ...ommunity.aws.ec2_vpc_egress_igw_module.rst | 4 +- ...community.aws.ec2_vpc_nacl_info_module.rst | 5 +- docs/community.aws.ec2_vpc_nacl_module.rst | 4 +- docs/community.aws.ec2_vpc_peer_module.rst | 4 +- ...munity.aws.ec2_vpc_peering_info_module.rst | 5 +- ...ty.aws.ec2_vpc_route_table_info_module.rst | 5 +- ...mmunity.aws.ec2_vpc_route_table_module.rst | 4 +- .../community.aws.ec2_vpc_vgw_info_module.rst | 5 +- docs/community.aws.ec2_vpc_vgw_module.rst | 4 +- .../community.aws.ec2_vpc_vpn_info_module.rst | 5 +- docs/community.aws.ec2_vpc_vpn_module.rst | 4 +- .../community.aws.ec2_win_password_module.rst | 4 +- docs/community.aws.ecs_attribute_module.rst | 4 +- docs/community.aws.ecs_cluster_module.rst | 4 +- docs/community.aws.ecs_ecr_module.rst | 4 +- .../community.aws.ecs_service_info_module.rst | 5 +- docs/community.aws.ecs_service_module.rst | 4 +- docs/community.aws.ecs_tag_module.rst | 4 +- docs/community.aws.ecs_task_module.rst | 4 +- ...ity.aws.ecs_taskdefinition_info_module.rst | 5 +- ...ommunity.aws.ecs_taskdefinition_module.rst | 4 +- docs/community.aws.efs_info_module.rst | 7 +- docs/community.aws.efs_module.rst | 4 +- docs/community.aws.efs_tag_module.rst | 4 +- .../community.aws.elasticache_info_module.rst | 5 +- docs/community.aws.elasticache_module.rst | 4 +- ...aws.elasticache_parameter_group_module.rst | 4 +- ...munity.aws.elasticache_snapshot_module.rst | 4 +- ...ty.aws.elasticache_subnet_group_module.rst | 4 +- ...ity.aws.elb_application_lb_info_module.rst | 5 +- ...ommunity.aws.elb_application_lb_module.rst | 4 +- ...mmunity.aws.elb_classic_lb_info_module.rst | 5 +- docs/community.aws.elb_instance_module.rst | 4 +- docs/community.aws.elb_network_lb_module.rst | 4 +- ...unity.aws.elb_target_group_info_module.rst | 5 +- .../community.aws.elb_target_group_module.rst | 4 +- docs/community.aws.elb_target_info_module.rst | 5 +- docs/community.aws.elb_target_module.rst | 4 +- docs/community.aws.execute_lambda_module.rst | 4 +- ...mmunity.aws.iam_access_key_info_module.rst | 4 +- docs/community.aws.iam_access_key_module.rst | 4 +- docs/community.aws.iam_group_module.rst | 4 +- ...ommunity.aws.iam_managed_policy_module.rst | 4 +- ...mmunity.aws.iam_mfa_device_info_module.rst | 5 +- ...mmunity.aws.iam_password_policy_module.rst | 4 +- docs/community.aws.iam_policy_info_module.rst | 4 +- docs/community.aws.iam_policy_module.rst | 4 +- docs/community.aws.iam_role_info_module.rst | 5 +- docs/community.aws.iam_role_module.rst | 4 +- ...mmunity.aws.iam_saml_federation_module.rst | 4 +- ...aws.iam_server_certificate_info_module.rst | 5 +- ...nity.aws.iam_server_certificate_module.rst | 4 +- docs/community.aws.iam_user_info_module.rst | 10 +- docs/community.aws.iam_user_module.rst | 111 +- docs/community.aws.kinesis_stream_module.rst | 4 +- docs/community.aws.lambda_alias_module.rst | 4 +- docs/community.aws.lambda_event_module.rst | 4 +- docs/community.aws.lambda_facts_module.rst | 398 ---- docs/community.aws.lambda_info_module.rst | 4 +- docs/community.aws.lambda_module.rst | 4 +- docs/community.aws.lambda_policy_module.rst | 4 +- docs/community.aws.lightsail_module.rst | 4 +- ...community.aws.rds_instance_info_module.rst | 5 +- docs/community.aws.rds_instance_module.rst | 4 +- ...unity.aws.rds_instance_snapshot_module.rst | 4 +- docs/community.aws.rds_module.rst | 1718 ----------------- ...unity.aws.rds_option_group_info_module.rst | 4 +- .../community.aws.rds_option_group_module.rst | 4 +- docs/community.aws.rds_param_group_module.rst | 4 +- ...community.aws.rds_snapshot_info_module.rst | 5 +- .../community.aws.rds_subnet_group_module.rst | 4 +- ...redshift_cross_region_snapshots_module.rst | 4 +- docs/community.aws.redshift_info_module.rst | 5 +- docs/community.aws.redshift_module.rst | 4 +- ...unity.aws.redshift_subnet_group_module.rst | 4 +- ...munity.aws.route53_health_check_module.rst | 4 +- docs/community.aws.route53_info_module.rst | 10 +- docs/community.aws.route53_module.rst | 5 +- docs/community.aws.route53_zone_module.rst | 4 +- ...nity.aws.s3_bucket_notification_module.rst | 4 +- docs/community.aws.s3_lifecycle_module.rst | 4 +- docs/community.aws.s3_logging_module.rst | 4 +- ...ty.aws.s3_metrics_configuration_module.rst | 4 +- docs/community.aws.s3_sync_module.rst | 4 +- docs/community.aws.s3_website_module.rst | 4 +- docs/community.aws.sns_module.rst | 4 +- docs/community.aws.sns_topic_module.rst | 4 +- docs/community.aws.sqs_queue_module.rst | 5 +- docs/community.aws.sts_assume_role_module.rst | 4 +- ...community.aws.sts_session_token_module.rst | 4 +- ...community.aws.wafv2_ip_set_info_module.rst | 4 +- docs/community.aws.wafv2_ip_set_module.rst | 4 +- ...munity.aws.wafv2_resources_info_module.rst | 4 +- docs/community.aws.wafv2_resources_module.rst | 4 +- ...unity.aws.wafv2_rule_group_info_module.rst | 4 +- .../community.aws.wafv2_rule_group_module.rst | 4 +- ...ommunity.aws.wafv2_web_acl_info_module.rst | 4 +- docs/community.aws.wafv2_web_acl_module.rst | 60 +- galaxy.yml | 4 +- meta/runtime.yml | 27 - tests/requirements.yml | 4 +- 197 files changed, 1058 insertions(+), 3144 deletions(-) delete mode 100644 changelogs/fragments/14532-remove-deprecations.yml delete mode 100644 changelogs/fragments/480-aws_glue_job-python-glue-version.yml delete mode 100644 changelogs/fragments/763-aws_ssm_connection-add-sse-parameters.yml delete mode 100644 changelogs/fragments/801-fix-delete-without-ttl.yml delete mode 100644 changelogs/fragments/809-botocore-1-19-0.yml delete mode 100644 changelogs/fragments/813-route53_info-fix-max_items.yml delete mode 100644 changelogs/fragments/818-fix-eks-short-name.yml delete mode 100644 changelogs/fragments/822-add-password-support-iam_user.yml delete mode 100644 changelogs/fragments/837-make-deprecated-dynamodb_table-updates-fail.yml.yml delete mode 100644 changelogs/fragments/838-ignore-deprecated-param-aws_kms_info.yml delete mode 100644 changelogs/fragments/remove_deprecated_facts.yml rename docs/{community.aws.iam_module.rst => community.aws.ec2_asg_scheduled_action_module.rst} (69%) delete mode 100644 docs/community.aws.ec2_elb_info_module.rst delete mode 100644 docs/community.aws.lambda_facts_module.rst delete mode 100644 docs/community.aws.rds_module.rst diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 787b8c5ab44..ea22c435256 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -5,6 +5,77 @@ community.aws Release Notes .. contents:: Topics +v3.0.0 +====== + +Major Changes +------------- + +- community.aws collection - The community.aws collection has dropped support for ``botocore<1.19.0`` and ``boto3<1.16.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/community.aws/pull/809). + +Minor Changes +------------- + +- aws_glue_job - Added ``command_python_version`` parameter (https://github.com/ansible-collections/community.aws/pull/480). +- aws_glue_job - Added ``glue_version`` parameter (https://github.com/ansible-collections/community.aws/pull/480). +- aws_glue_job - Added support for check mode (https://github.com/ansible-collections/community.aws/pull/480). +- aws_glue_job - Added support for tags (https://github.com/ansible-collections/community.aws/pull/480). +- aws_ssm connection plugin - add parameters to explicitly specify SSE mode and KMS key id for uploads on the file transfer bucket. (https://github.com/ansible-collections/community.aws/pull/763) +- iam_user - add boto3 waiter for iam user creation (https://github.com/ansible-collections/community.aws/pull/822). +- iam_user - add password management support bringing parity with `iam` module (https://github.com/ansible-collections/community.aws/pull/822). +- route53 - ``ttl`` and ``value`` are not required for deleting records (https://github.com/ansible-collections/community.aws/pull/801). +- route53_info - `max_items` and `type` are no longer ignored fixing a regression (https://github.com/ansible-collections/community.aws/pull/813). + +Breaking Changes / Porting Guide +-------------------------------- + +- aws_acm_facts - Remove deprecated alias ``aws_acm_facts``. Please use ``aws_acm_info`` instead. +- aws_kms_facts - Remove deprecated alias ``aws_kms_facts``. Please use ``aws_kms_info`` instead. +- aws_kms_info - Deprecated ``keys_attr`` field is now ignored (https://github.com/ansible-collections/community.aws/pull/838). +- aws_region_facts - Remove deprecated alias ``aws_region_facts``. Please use ``aws_region_info`` instead. +- aws_s3_bucket_facts - Remove deprecated alias ``aws_s3_bucket_facts``. Please use ``aws_s3_bucket_info`` instead. +- aws_sgw_facts - Remove deprecated alias ``aws_sgw_facts``. Please use ``aws_sgw_info`` instead. +- aws_waf_facts - Remove deprecated alias ``aws_waf_facts``. Please use ``aws_waf_info`` instead. +- cloudfront_facts - Remove deprecated alias ``cloudfront_facts``. Please use ``cloudfront_info`` instead. +- cloudwatchlogs_log_group_facts - Remove deprecated alias ``cloudwatchlogs_log_group_facts``. Please use ``cloudwatchlogs_log_group_info`` instead. +- dynamodb_table - deprecated updates currently ignored for primary keys and global_all indexes will now result in a failure. (https://github.com/ansible-collections/community.aws/pull/837). +- ec2_asg_facts - Remove deprecated alias ``ec2_asg_facts``. Please use ``ec2_asg_info`` instead. +- ec2_customer_gateway_facts - Remove deprecated alias ``ec2_customer_gateway_facts``. Please use ``ec2_customer_gateway_info`` instead. +- ec2_eip_facts - Remove deprecated alias ``ec2_eip_facts``. Please use ``ec2_eip_info`` instead. +- ec2_elb_facts - Remove deprecated alias ``ec2_elb_facts``. Please use ``ec2_elb_info`` instead. +- ec2_elb_info - The ``ec2_elb_info`` module has been removed. Please use ``the ``elb_classic_lb_info`` module. +- ec2_lc_facts - Remove deprecated alias ``ec2_lc_facts``. Please use ``ec2_lc_info`` instead. +- ec2_placement_group_facts - Remove deprecated alias ``ec2_placement_group_facts``. Please use ``ec2_placement_group_info`` instead. +- ec2_vpc_nacl_facts - Remove deprecated alias ``ec2_vpc_nacl_facts``. Please use ``ec2_vpc_nacl_info`` instead. +- ec2_vpc_peering_facts - Remove deprecated alias ``ec2_vpc_peering_facts``. Please use ``ec2_vpc_peering_info`` instead. +- ec2_vpc_route_table_facts - Remove deprecated alias ``ec2_vpc_route_table_facts``. Please use ``ec2_vpc_route_table_info`` instead. +- ec2_vpc_vgw_facts - Remove deprecated alias ``ec2_vpc_vgw_facts``. Please use ``ec2_vpc_vgw_info`` instead. +- ec2_vpc_vpn_facts - Remove deprecated alias ``ec2_vpc_vpn_facts``. Please use ``ec2_vpc_vpn_info`` instead. +- ecs_service_facts - Remove deprecated alias ``ecs_service_facts``. Please use ``ecs_service_info`` instead. +- ecs_taskdefinition_facts - Remove deprecated alias ``ecs_taskdefinition_facts``. Please use ``ecs_taskdefinition_info`` instead. +- efs_facts - Remove deprecated alias ``efs_facts``. Please use ``efs_info`` instead. +- elasticache_facts - Remove deprecated alias ``elasticache_facts``. Please use ``elasticache_info`` instead. +- elb_application_lb_facts - Remove deprecated alias ``elb_application_lb_facts``. Please use ``elb_application_lb_info`` instead. +- elb_classic_lb_facts - Remove deprecated alias ``elb_classic_lb_facts``. Please use ``elb_classic_lb_info`` instead. +- elb_target_facts - Remove deprecated alias ``elb_target_facts``. Please use ``elb_target_info`` instead. +- elb_target_group_facts - Remove deprecated alias ``elb_target_group_facts``. Please use ``elb_target_group_info`` instead. +- iam - Removed deprecated ``community.aws.iam`` module. Please use ``community.aws.iam_user``, ``community.aws.iam_access_key`` or ``community.aws.iam_group`` (https://github.com/ansible-collections/community.aws/pull/839). +- iam_cert_facts - Remove deprecated alias ``iam_cert_facts``. Please use ``iam_cert_info`` instead. +- iam_mfa_device_facts - Remove deprecated alias ``iam_mfa_device_facts``. Please use ``iam_mfa_device_info`` instead. +- iam_role_facts - Remove deprecated alias ``iam_role_facts``. Please use ``iam_role_info`` instead. +- iam_server_certificate_facts - Remove deprecated alias ``iam_server_certificate_facts``. Please use ``iam_server_certificate_info`` instead. +- lambda_facts - Remove deprecated module lambda_facts``. Please use ``lambda_info`` instead. +- rds - Removed deprecated ``community.aws.rds`` module. Please use ``community.aws.rds_instance`` (https://github.com/ansible-collections/community.aws/pull/839). +- rds_instance_facts - Remove deprecated alias ``rds_instance_facts``. Please use ``rds_instance_info`` instead. +- rds_snapshot_facts - Remove deprecated alias ``rds_snapshot_facts``. Please use ``rds_snapshot_info`` instead. +- redshift_facts - Remove deprecated alias ``redshift_facts``. Please use ``redshift_info`` instead. +- route53_facts - Remove deprecated alias ``route53_facts``. Please use ``route53_info`` instead. + +Bugfixes +-------- + +- aws_eks - Fix EKS cluster creation with short names (https://github.com/ansible-collections/community.aws/pull/818). + v2.1.0 ====== diff --git a/README.md b/README.md index 3bfa13b4495..5b47bee3aa8 100644 --- a/README.md +++ b/README.md @@ -96,11 +96,11 @@ Name | Description [community.aws.ec2_asg](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.ec2_asg_module.rst)|Create or delete AWS AutoScaling Groups (ASGs) [community.aws.ec2_asg_info](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.ec2_asg_info_module.rst)|Gather information about ec2 Auto Scaling Groups (ASGs) in AWS [community.aws.ec2_asg_lifecycle_hook](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.ec2_asg_lifecycle_hook_module.rst)|Create, delete or update AWS ASG Lifecycle Hooks. +[community.aws.ec2_asg_scheduled_action](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.ec2_asg_scheduled_action_module.rst)|Create, modify and delete ASG scheduled scaling actions. [community.aws.ec2_customer_gateway](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.ec2_customer_gateway_module.rst)|Manage an AWS customer gateway [community.aws.ec2_customer_gateway_info](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.ec2_customer_gateway_info_module.rst)|Gather information about customer gateways in AWS [community.aws.ec2_eip](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.ec2_eip_module.rst)|manages EC2 elastic IP (EIP) addresses. [community.aws.ec2_eip_info](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.ec2_eip_info_module.rst)|List EC2 EIP details -[community.aws.ec2_elb_info](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.ec2_elb_info_module.rst)|Gather information about EC2 Elastic Load Balancers in AWS [community.aws.ec2_launch_template](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.ec2_launch_template_module.rst)|Manage EC2 launch templates [community.aws.ec2_lc](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.ec2_lc_module.rst)|Create or delete AWS Autoscaling Launch Configurations [community.aws.ec2_lc_find](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.ec2_lc_find_module.rst)|Find AWS Autoscaling Launch Configurations @@ -151,7 +151,6 @@ Name | Description [community.aws.elb_target_group_info](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.elb_target_group_info_module.rst)|Gather information about ELB target groups in AWS [community.aws.elb_target_info](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.elb_target_info_module.rst)|Gathers which target groups a target is associated with. [community.aws.execute_lambda](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.execute_lambda_module.rst)|Execute an AWS Lambda function -[community.aws.iam](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.iam_module.rst)|Manage IAM users, groups, roles and keys [community.aws.iam_access_key](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.iam_access_key_module.rst)|Manage AWS IAM User access keys [community.aws.iam_access_key_info](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.iam_access_key_info_module.rst)|fetch information about AWS IAM User access keys [community.aws.iam_group](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.iam_group_module.rst)|Manage AWS IAM groups @@ -171,11 +170,9 @@ Name | Description [community.aws.lambda](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.lambda_module.rst)|Manage AWS Lambda functions [community.aws.lambda_alias](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.lambda_alias_module.rst)|Creates, updates or deletes AWS Lambda function aliases [community.aws.lambda_event](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.lambda_event_module.rst)|Creates, updates or deletes AWS Lambda function event mappings -[community.aws.lambda_facts](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.lambda_facts_module.rst)|Gathers AWS Lambda function details as Ansible facts [community.aws.lambda_info](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.lambda_info_module.rst)|Gathers AWS Lambda function details [community.aws.lambda_policy](https://github.com/ansible-collections/community.aws/blob/main/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/main/docs/community.aws.lightsail_module.rst)|Manage instances in AWS Lightsail -[community.aws.rds](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.rds_module.rst)|create, delete, or modify Amazon rds instances, rds snapshots, and related facts [community.aws.rds_instance](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.rds_instance_module.rst)|Manage RDS instances [community.aws.rds_instance_info](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.rds_instance_info_module.rst)|obtain information about one or more RDS instances [community.aws.rds_instance_snapshot](https://github.com/ansible-collections/community.aws/blob/main/docs/community.aws.rds_instance_snapshot_module.rst)|manage Amazon RDS snapshots. diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml index e5302aad24d..3dfa555627a 100644 --- a/changelogs/changelog.yaml +++ b/changelogs/changelog.yaml @@ -1500,3 +1500,122 @@ releases: name: rds_option_group_info namespace: '' release_date: '2021-11-12' + 3.0.0: + changes: + breaking_changes: + - aws_acm_facts - Remove deprecated alias ``aws_acm_facts``. Please use ``aws_acm_info`` + instead. + - aws_kms_facts - Remove deprecated alias ``aws_kms_facts``. Please use ``aws_kms_info`` + instead. + - aws_kms_info - Deprecated ``keys_attr`` field is now ignored (https://github.com/ansible-collections/community.aws/pull/838). + - aws_region_facts - Remove deprecated alias ``aws_region_facts``. Please + use ``aws_region_info`` instead. + - aws_s3_bucket_facts - Remove deprecated alias ``aws_s3_bucket_facts``. Please + use ``aws_s3_bucket_info`` instead. + - aws_sgw_facts - Remove deprecated alias ``aws_sgw_facts``. Please use ``aws_sgw_info`` + instead. + - aws_waf_facts - Remove deprecated alias ``aws_waf_facts``. Please use ``aws_waf_info`` + instead. + - cloudfront_facts - Remove deprecated alias ``cloudfront_facts``. Please + use ``cloudfront_info`` instead. + - cloudwatchlogs_log_group_facts - Remove deprecated alias ``cloudwatchlogs_log_group_facts``. Please + use ``cloudwatchlogs_log_group_info`` instead. + - dynamodb_table - deprecated updates currently ignored for primary keys and + global_all indexes will now result in a failure. (https://github.com/ansible-collections/community.aws/pull/837). + - ec2_asg_facts - Remove deprecated alias ``ec2_asg_facts``. Please use ``ec2_asg_info`` + instead. + - ec2_customer_gateway_facts - Remove deprecated alias ``ec2_customer_gateway_facts``. Please + use ``ec2_customer_gateway_info`` instead. + - ec2_eip_facts - Remove deprecated alias ``ec2_eip_facts``. Please use ``ec2_eip_info`` + instead. + - ec2_elb_facts - Remove deprecated alias ``ec2_elb_facts``. Please use ``ec2_elb_info`` + instead. + - ec2_elb_info - The ``ec2_elb_info`` module has been removed. Please use + ``the ``elb_classic_lb_info`` module. + - ec2_lc_facts - Remove deprecated alias ``ec2_lc_facts``. Please use ``ec2_lc_info`` + instead. + - ec2_placement_group_facts - Remove deprecated alias ``ec2_placement_group_facts``. Please + use ``ec2_placement_group_info`` instead. + - ec2_vpc_nacl_facts - Remove deprecated alias ``ec2_vpc_nacl_facts``. Please + use ``ec2_vpc_nacl_info`` instead. + - ec2_vpc_peering_facts - Remove deprecated alias ``ec2_vpc_peering_facts``. Please + use ``ec2_vpc_peering_info`` instead. + - ec2_vpc_route_table_facts - Remove deprecated alias ``ec2_vpc_route_table_facts``. Please + use ``ec2_vpc_route_table_info`` instead. + - ec2_vpc_vgw_facts - Remove deprecated alias ``ec2_vpc_vgw_facts``. Please + use ``ec2_vpc_vgw_info`` instead. + - ec2_vpc_vpn_facts - Remove deprecated alias ``ec2_vpc_vpn_facts``. Please + use ``ec2_vpc_vpn_info`` instead. + - ecs_service_facts - Remove deprecated alias ``ecs_service_facts``. Please + use ``ecs_service_info`` instead. + - ecs_taskdefinition_facts - Remove deprecated alias ``ecs_taskdefinition_facts``. Please + use ``ecs_taskdefinition_info`` instead. + - efs_facts - Remove deprecated alias ``efs_facts``. Please use ``efs_info`` + instead. + - elasticache_facts - Remove deprecated alias ``elasticache_facts``. Please + use ``elasticache_info`` instead. + - elb_application_lb_facts - Remove deprecated alias ``elb_application_lb_facts``. Please + use ``elb_application_lb_info`` instead. + - elb_classic_lb_facts - Remove deprecated alias ``elb_classic_lb_facts``. Please + use ``elb_classic_lb_info`` instead. + - elb_target_facts - Remove deprecated alias ``elb_target_facts``. Please + use ``elb_target_info`` instead. + - elb_target_group_facts - Remove deprecated alias ``elb_target_group_facts``. Please + use ``elb_target_group_info`` instead. + - iam - Removed deprecated ``community.aws.iam`` module. Please use ``community.aws.iam_user``, + ``community.aws.iam_access_key`` or ``community.aws.iam_group`` (https://github.com/ansible-collections/community.aws/pull/839). + - iam_cert_facts - Remove deprecated alias ``iam_cert_facts``. Please use + ``iam_cert_info`` instead. + - iam_mfa_device_facts - Remove deprecated alias ``iam_mfa_device_facts``. Please + use ``iam_mfa_device_info`` instead. + - iam_role_facts - Remove deprecated alias ``iam_role_facts``. Please use + ``iam_role_info`` instead. + - iam_server_certificate_facts - Remove deprecated alias ``iam_server_certificate_facts``. Please + use ``iam_server_certificate_info`` instead. + - lambda_facts - Remove deprecated module lambda_facts``. Please use ``lambda_info`` + instead. + - rds - Removed deprecated ``community.aws.rds`` module. Please use ``community.aws.rds_instance`` + (https://github.com/ansible-collections/community.aws/pull/839). + - rds_instance_facts - Remove deprecated alias ``rds_instance_facts``. Please + use ``rds_instance_info`` instead. + - rds_snapshot_facts - Remove deprecated alias ``rds_snapshot_facts``. Please + use ``rds_snapshot_info`` instead. + - redshift_facts - Remove deprecated alias ``redshift_facts``. Please use + ``redshift_info`` instead. + - route53_facts - Remove deprecated alias ``route53_facts``. Please use ``route53_info`` + instead. + bugfixes: + - aws_eks - Fix EKS cluster creation with short names (https://github.com/ansible-collections/community.aws/pull/818). + major_changes: + - community.aws collection - The community.aws collection has dropped support + for ``botocore<1.19.0`` and ``boto3<1.16.0``. Most modules will continue to + work with older versions of the AWS SDK, however compatability with older + versions of the SDK is not guaranteed and will not be tested. When using older + versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/community.aws/pull/809). + minor_changes: + - aws_glue_job - Added ``command_python_version`` parameter (https://github.com/ansible-collections/community.aws/pull/480). + - aws_glue_job - Added ``glue_version`` parameter (https://github.com/ansible-collections/community.aws/pull/480). + - aws_glue_job - Added support for check mode (https://github.com/ansible-collections/community.aws/pull/480). + - aws_glue_job - Added support for tags (https://github.com/ansible-collections/community.aws/pull/480). + - aws_ssm connection plugin - add parameters to explicitly specify SSE mode + and KMS key id for uploads on the file transfer bucket. (https://github.com/ansible-collections/community.aws/pull/763) + - iam_user - add boto3 waiter for iam user creation (https://github.com/ansible-collections/community.aws/pull/822). + - iam_user - add password management support bringing parity with `iam` module + (https://github.com/ansible-collections/community.aws/pull/822). + - route53 - ``ttl`` and ``value`` are not required for deleting records (https://github.com/ansible-collections/community.aws/pull/801). + - route53_info - `max_items` and `type` are no longer ignored fixing a regression + (https://github.com/ansible-collections/community.aws/pull/813). + fragments: + - 14532-remove-deprecations.yml + - 3.0.0.yml + - 480-aws_glue_job-python-glue-version.yml + - 763-aws_ssm_connection-add-sse-parameters.yml + - 801-fix-delete-without-ttl.yml + - 809-botocore-1-19-0.yml + - 813-route53_info-fix-max_items.yml + - 818-fix-eks-short-name.yml + - 822-add-password-support-iam_user.yml + - 837-make-deprecated-dynamodb_table-updates-fail.yml.yml + - 838-ignore-deprecated-param-aws_kms_info.yml + - remove_deprecated_facts.yml + release_date: '2022-01-06' diff --git a/changelogs/fragments/14532-remove-deprecations.yml b/changelogs/fragments/14532-remove-deprecations.yml deleted file mode 100644 index 29ef3621ad8..00000000000 --- a/changelogs/fragments/14532-remove-deprecations.yml +++ /dev/null @@ -1,3 +0,0 @@ -breaking_changes: -- iam - Removed deprecated ``community.aws.iam`` module. Please use ``community.aws.iam_user``, ``community.aws.iam_access_key`` or ``community.aws.iam_group`` (https://github.com/ansible-collections/community.aws/pull/839). -- rds - Removed deprecated ``community.aws.rds`` module. Please use ``community.aws.rds_instance`` (https://github.com/ansible-collections/community.aws/pull/839). \ No newline at end of file diff --git a/changelogs/fragments/480-aws_glue_job-python-glue-version.yml b/changelogs/fragments/480-aws_glue_job-python-glue-version.yml deleted file mode 100644 index a277d0bcc3d..00000000000 --- a/changelogs/fragments/480-aws_glue_job-python-glue-version.yml +++ /dev/null @@ -1,5 +0,0 @@ -minor_changes: - - aws_glue_job - Added ``glue_version`` parameter (https://github.com/ansible-collections/community.aws/pull/480). - - aws_glue_job - Added ``command_python_version`` parameter (https://github.com/ansible-collections/community.aws/pull/480). - - aws_glue_job - Added support for check mode (https://github.com/ansible-collections/community.aws/pull/480). - - aws_glue_job - Added support for tags (https://github.com/ansible-collections/community.aws/pull/480). diff --git a/changelogs/fragments/763-aws_ssm_connection-add-sse-parameters.yml b/changelogs/fragments/763-aws_ssm_connection-add-sse-parameters.yml deleted file mode 100644 index 9074a5e6862..00000000000 --- a/changelogs/fragments/763-aws_ssm_connection-add-sse-parameters.yml +++ /dev/null @@ -1,2 +0,0 @@ -minor_changes: - - aws_ssm connection plugin - add parameters to explicitly specify SSE mode and KMS key id for uploads on the file transfer bucket. (https://github.com/ansible-collections/community.aws/pull/763) diff --git a/changelogs/fragments/801-fix-delete-without-ttl.yml b/changelogs/fragments/801-fix-delete-without-ttl.yml deleted file mode 100644 index 35affec9a82..00000000000 --- a/changelogs/fragments/801-fix-delete-without-ttl.yml +++ /dev/null @@ -1,2 +0,0 @@ -minor_changes: -- route53 - ``ttl`` and ``value`` are not required for deleting records (https://github.com/ansible-collections/community.aws/pull/801). \ No newline at end of file diff --git a/changelogs/fragments/809-botocore-1-19-0.yml b/changelogs/fragments/809-botocore-1-19-0.yml deleted file mode 100644 index 5b30d98650a..00000000000 --- a/changelogs/fragments/809-botocore-1-19-0.yml +++ /dev/null @@ -1,7 +0,0 @@ -major_changes: -- community.aws collection - The community.aws collection has dropped support for - ``botocore<1.19.0`` and ``boto3<1.16.0``. Most modules will continue to work - with older versions of the AWS SDK, however compatability with older versions - of the SDK is not guaranteed and will not be tested. When using older versions - of the SDK a warning will be emitted by Ansible - (https://github.com/ansible-collections/community.aws/pull/809). diff --git a/changelogs/fragments/813-route53_info-fix-max_items.yml b/changelogs/fragments/813-route53_info-fix-max_items.yml deleted file mode 100644 index 8280f9a81d1..00000000000 --- a/changelogs/fragments/813-route53_info-fix-max_items.yml +++ /dev/null @@ -1,2 +0,0 @@ -minor_changes: - - route53_info - `max_items` and `type` are no longer ignored fixing a regression (https://github.com/ansible-collections/community.aws/pull/813). diff --git a/changelogs/fragments/818-fix-eks-short-name.yml b/changelogs/fragments/818-fix-eks-short-name.yml deleted file mode 100644 index 509519946dd..00000000000 --- a/changelogs/fragments/818-fix-eks-short-name.yml +++ /dev/null @@ -1,2 +0,0 @@ -bugfixes: -- aws_eks - Fix EKS cluster creation with short names (https://github.com/ansible-collections/community.aws/pull/818). \ No newline at end of file diff --git a/changelogs/fragments/822-add-password-support-iam_user.yml b/changelogs/fragments/822-add-password-support-iam_user.yml deleted file mode 100644 index f02312d536e..00000000000 --- a/changelogs/fragments/822-add-password-support-iam_user.yml +++ /dev/null @@ -1,3 +0,0 @@ -minor_changes: - - iam_user - add password management support bringing parity with `iam` module (https://github.com/ansible-collections/community.aws/pull/822). - - iam_user - add boto3 waiter for iam user creation (https://github.com/ansible-collections/community.aws/pull/822). diff --git a/changelogs/fragments/837-make-deprecated-dynamodb_table-updates-fail.yml.yml b/changelogs/fragments/837-make-deprecated-dynamodb_table-updates-fail.yml.yml deleted file mode 100644 index e8980ee661d..00000000000 --- a/changelogs/fragments/837-make-deprecated-dynamodb_table-updates-fail.yml.yml +++ /dev/null @@ -1,3 +0,0 @@ -breaking_changes: -- dynamodb_table - deprecated updates currently ignored for primary keys and global_all indexes will now result in a failure. - (https://github.com/ansible-collections/community.aws/pull/837). diff --git a/changelogs/fragments/838-ignore-deprecated-param-aws_kms_info.yml b/changelogs/fragments/838-ignore-deprecated-param-aws_kms_info.yml deleted file mode 100644 index 403d96d1e27..00000000000 --- a/changelogs/fragments/838-ignore-deprecated-param-aws_kms_info.yml +++ /dev/null @@ -1,2 +0,0 @@ -deprecated_features: - - aws_kms_info - Deprecated ``keys_attr`` field is now ignored and will be removed in version 4.0.0 (https://github.com/ansible-collections/community.aws/pull/838). diff --git a/changelogs/fragments/remove_deprecated_facts.yml b/changelogs/fragments/remove_deprecated_facts.yml deleted file mode 100644 index 74c4b38fc6c..00000000000 --- a/changelogs/fragments/remove_deprecated_facts.yml +++ /dev/null @@ -1,38 +0,0 @@ -breaking_changes: - - aws_acm_facts - Remove deprecated alias ``aws_acm_facts``. Please use ``aws_acm_info`` instead. - - aws_kms_facts - Remove deprecated alias ``aws_kms_facts``. Please use ``aws_kms_info`` instead. - - aws_region_facts - Remove deprecated alias ``aws_region_facts``. Please use ``aws_region_info`` instead. - - aws_s3_bucket_facts - Remove deprecated alias ``aws_s3_bucket_facts``. Please use ``aws_s3_bucket_info`` instead. - - aws_sgw_facts - Remove deprecated alias ``aws_sgw_facts``. Please use ``aws_sgw_info`` instead. - - aws_waf_facts - Remove deprecated alias ``aws_waf_facts``. Please use ``aws_waf_info`` instead. - - cloudfront_facts - Remove deprecated alias ``cloudfront_facts``. Please use ``cloudfront_info`` instead. - - cloudwatchlogs_log_group_facts - Remove deprecated alias ``cloudwatchlogs_log_group_facts``. Please use ``cloudwatchlogs_log_group_info`` instead. - - ec2_asg_facts - Remove deprecated alias ``ec2_asg_facts``. Please use ``ec2_asg_info`` instead. - - ec2_customer_gateway_facts - Remove deprecated alias ``ec2_customer_gateway_facts``. Please use ``ec2_customer_gateway_info`` instead. - - ec2_eip_facts - Remove deprecated alias ``ec2_eip_facts``. Please use ``ec2_eip_info`` instead. - - ec2_elb_facts - Remove deprecated alias ``ec2_elb_facts``. Please use ``ec2_elb_info`` instead. - - ec2_lc_facts - Remove deprecated alias ``ec2_lc_facts``. Please use ``ec2_lc_info`` instead. - - ec2_placement_group_facts - Remove deprecated alias ``ec2_placement_group_facts``. Please use ``ec2_placement_group_info`` instead. - - ec2_vpc_nacl_facts - Remove deprecated alias ``ec2_vpc_nacl_facts``. Please use ``ec2_vpc_nacl_info`` instead. - - ec2_vpc_peering_facts - Remove deprecated alias ``ec2_vpc_peering_facts``. Please use ``ec2_vpc_peering_info`` instead. - - ec2_vpc_route_table_facts - Remove deprecated alias ``ec2_vpc_route_table_facts``. Please use ``ec2_vpc_route_table_info`` instead. - - ec2_vpc_vgw_facts - Remove deprecated alias ``ec2_vpc_vgw_facts``. Please use ``ec2_vpc_vgw_info`` instead. - - ec2_vpc_vpn_facts - Remove deprecated alias ``ec2_vpc_vpn_facts``. Please use ``ec2_vpc_vpn_info`` instead. - - ecs_service_facts - Remove deprecated alias ``ecs_service_facts``. Please use ``ecs_service_info`` instead. - - ecs_taskdefinition_facts - Remove deprecated alias ``ecs_taskdefinition_facts``. Please use ``ecs_taskdefinition_info`` instead. - - efs_facts - Remove deprecated alias ``efs_facts``. Please use ``efs_info`` instead. - - elasticache_facts - Remove deprecated alias ``elasticache_facts``. Please use ``elasticache_info`` instead. - - elb_application_lb_facts - Remove deprecated alias ``elb_application_lb_facts``. Please use ``elb_application_lb_info`` instead. - - elb_classic_lb_facts - Remove deprecated alias ``elb_classic_lb_facts``. Please use ``elb_classic_lb_info`` instead. - - elb_target_facts - Remove deprecated alias ``elb_target_facts``. Please use ``elb_target_info`` instead. - - elb_target_group_facts - Remove deprecated alias ``elb_target_group_facts``. Please use ``elb_target_group_info`` instead. - - iam_cert_facts - Remove deprecated alias ``iam_cert_facts``. Please use ``iam_cert_info`` instead. - - iam_mfa_device_facts - Remove deprecated alias ``iam_mfa_device_facts``. Please use ``iam_mfa_device_info`` instead. - - iam_role_facts - Remove deprecated alias ``iam_role_facts``. Please use ``iam_role_info`` instead. - - iam_server_certificate_facts - Remove deprecated alias ``iam_server_certificate_facts``. Please use ``iam_server_certificate_info`` instead. - - lambda_facts - Remove deprecated module lambda_facts``. Please use ``lambda_info`` instead. - - rds_instance_facts - Remove deprecated alias ``rds_instance_facts``. Please use ``rds_instance_info`` instead. - - rds_snapshot_facts - Remove deprecated alias ``rds_snapshot_facts``. Please use ``rds_snapshot_info`` instead. - - redshift_facts - Remove deprecated alias ``redshift_facts``. Please use ``redshift_info`` instead. - - route53_facts - Remove deprecated alias ``route53_facts``. Please use ``route53_info`` instead. - - ec2_elb_info - The ``ec2_elb_info`` module has been removed. Please use ``the ``elb_classic_lb_info`` module. diff --git a/docs/community.aws.aws_acm_info_module.rst b/docs/community.aws.aws_acm_info_module.rst index c604a405734..b7c06305302 100644 --- a/docs/community.aws.aws_acm_info_module.rst +++ b/docs/community.aws.aws_acm_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Retrieve information for ACM certificates -- This module was called ``aws_acm_facts`` before Ansible 2.9. The usage did not change. - Note that this will not return information about uploaded keys of size 4096 bits, due to a limitation of the ACM API. @@ -28,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_acm_module.rst b/docs/community.aws.aws_acm_module.rst index 57dbd56c4ba..ae76919ef89 100644 --- a/docs/community.aws.aws_acm_module.rst +++ b/docs/community.aws.aws_acm_module.rst @@ -42,8 +42,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_api_gateway_module.rst b/docs/community.aws.aws_api_gateway_module.rst index d7bcb550856..ae3357e3079 100644 --- a/docs/community.aws.aws_api_gateway_module.rst +++ b/docs/community.aws.aws_api_gateway_module.rst @@ -28,8 +28,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_application_scaling_policy_module.rst b/docs/community.aws.aws_application_scaling_policy_module.rst index 4606b53e9ae..b320ddb3fc2 100644 --- a/docs/community.aws.aws_application_scaling_policy_module.rst +++ b/docs/community.aws.aws_application_scaling_policy_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_batch_compute_environment_module.rst b/docs/community.aws.aws_batch_compute_environment_module.rst index d8d542942be..75cd5c4f7c9 100644 --- a/docs/community.aws.aws_batch_compute_environment_module.rst +++ b/docs/community.aws.aws_batch_compute_environment_module.rst @@ -28,8 +28,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_batch_job_definition_module.rst b/docs/community.aws.aws_batch_job_definition_module.rst index 93b37e4b1bc..9602a2b91d7 100644 --- a/docs/community.aws.aws_batch_job_definition_module.rst +++ b/docs/community.aws.aws_batch_job_definition_module.rst @@ -28,8 +28,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_batch_job_queue_module.rst b/docs/community.aws.aws_batch_job_queue_module.rst index a385c7624a5..c5f3dc29ef5 100644 --- a/docs/community.aws.aws_batch_job_queue_module.rst +++ b/docs/community.aws.aws_batch_job_queue_module.rst @@ -28,8 +28,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_codebuild_module.rst b/docs/community.aws.aws_codebuild_module.rst index 2d84d524e90..d626c6d9e9c 100644 --- a/docs/community.aws.aws_codebuild_module.rst +++ b/docs/community.aws.aws_codebuild_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_codecommit_module.rst b/docs/community.aws.aws_codecommit_module.rst index 9d30ec448f2..ade1a9b5902 100644 --- a/docs/community.aws.aws_codecommit_module.rst +++ b/docs/community.aws.aws_codecommit_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_codepipeline_module.rst b/docs/community.aws.aws_codepipeline_module.rst index b6b2cd3c410..c0d3810a90f 100644 --- a/docs/community.aws.aws_codepipeline_module.rst +++ b/docs/community.aws.aws_codepipeline_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_config_aggregation_authorization_module.rst b/docs/community.aws.aws_config_aggregation_authorization_module.rst index 2ce46985937..7bcb3ebfd71 100644 --- a/docs/community.aws.aws_config_aggregation_authorization_module.rst +++ b/docs/community.aws.aws_config_aggregation_authorization_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_config_aggregator_module.rst b/docs/community.aws.aws_config_aggregator_module.rst index 4dae621e755..2ddc02ae5f1 100644 --- a/docs/community.aws.aws_config_aggregator_module.rst +++ b/docs/community.aws.aws_config_aggregator_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_config_delivery_channel_module.rst b/docs/community.aws.aws_config_delivery_channel_module.rst index e2940cf6c41..f2189857725 100644 --- a/docs/community.aws.aws_config_delivery_channel_module.rst +++ b/docs/community.aws.aws_config_delivery_channel_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_config_recorder_module.rst b/docs/community.aws.aws_config_recorder_module.rst index 439de0efbee..4098c1968c4 100644 --- a/docs/community.aws.aws_config_recorder_module.rst +++ b/docs/community.aws.aws_config_recorder_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_config_rule_module.rst b/docs/community.aws.aws_config_rule_module.rst index 87e98cd929d..05028701e06 100644 --- a/docs/community.aws.aws_config_rule_module.rst +++ b/docs/community.aws.aws_config_rule_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_direct_connect_confirm_connection_module.rst b/docs/community.aws.aws_direct_connect_confirm_connection_module.rst index 66a9fa6acb4..c4b4b25e059 100644 --- a/docs/community.aws.aws_direct_connect_confirm_connection_module.rst +++ b/docs/community.aws.aws_direct_connect_confirm_connection_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_direct_connect_connection_module.rst b/docs/community.aws.aws_direct_connect_connection_module.rst index cff65666871..07d4cc47565 100644 --- a/docs/community.aws.aws_direct_connect_connection_module.rst +++ b/docs/community.aws.aws_direct_connect_connection_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_direct_connect_gateway_module.rst b/docs/community.aws.aws_direct_connect_gateway_module.rst index d8bcfb3fbb4..9c574b674f3 100644 --- a/docs/community.aws.aws_direct_connect_gateway_module.rst +++ b/docs/community.aws.aws_direct_connect_gateway_module.rst @@ -29,8 +29,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_direct_connect_link_aggregation_group_module.rst b/docs/community.aws.aws_direct_connect_link_aggregation_group_module.rst index 47a4b3f1a24..a1d3e4db233 100644 --- a/docs/community.aws.aws_direct_connect_link_aggregation_group_module.rst +++ b/docs/community.aws.aws_direct_connect_link_aggregation_group_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_direct_connect_virtual_interface_module.rst b/docs/community.aws.aws_direct_connect_virtual_interface_module.rst index cac6b60f287..34c12f951c4 100644 --- a/docs/community.aws.aws_direct_connect_virtual_interface_module.rst +++ b/docs/community.aws.aws_direct_connect_virtual_interface_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_eks_cluster_module.rst b/docs/community.aws.aws_eks_cluster_module.rst index 3bf9973bcdb..31b070a06c4 100644 --- a/docs/community.aws.aws_eks_cluster_module.rst +++ b/docs/community.aws.aws_eks_cluster_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_elasticbeanstalk_app_module.rst b/docs/community.aws.aws_elasticbeanstalk_app_module.rst index 3ad0c9fa24a..00631b26d4f 100644 --- a/docs/community.aws.aws_elasticbeanstalk_app_module.rst +++ b/docs/community.aws.aws_elasticbeanstalk_app_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_glue_connection_module.rst b/docs/community.aws.aws_glue_connection_module.rst index 04afb555c95..c92843da48b 100644 --- a/docs/community.aws.aws_glue_connection_module.rst +++ b/docs/community.aws.aws_glue_connection_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_glue_job_module.rst b/docs/community.aws.aws_glue_job_module.rst index 00f0e68946c..1075a779cfd 100644 --- a/docs/community.aws.aws_glue_job_module.rst +++ b/docs/community.aws.aws_glue_job_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters @@ -142,6 +142,23 @@ Parameters
The name of the job command. This must be 'glueetl'.
+ + +
+ command_python_version + +
+ string +
+
added in 2.2.0
+ + + + +
Python version being used to execute a Python shell job.
+
AWS currently supports '2' or '3'.
+ +
@@ -334,6 +351,27 @@ Parameters

aliases: aws_profile
+ + +
+ purge_tags + +
+ boolean +
+
added in 2.2.0
+ + +
    Choices: +
  • no
  • +
  • yes ←
  • +
+ + +
If true, existing tags will be purged from the resource to match exactly what is defined by tags parameter.
+
If the tags parameter is not set then tags will not be modified.
+ +
@@ -404,6 +442,23 @@ Parameters
Create or delete the AWS Glue job.
+ + +
+ tags + +
+ dictionary +
+
added in 2.2.0
+ + + + +
A hash/dictionary of tags to be applied to the job.
+
Remove completely or specify an empty dictionary to remove all tags.
+ +
@@ -483,7 +538,10 @@ Examples # Create an AWS Glue job - community.aws.aws_glue_job: - command_script_location: s3bucket/script.py + command_script_location: "s3://s3bucket/script.py" + default_arguments: + "--extra-py-files": s3://s3bucket/script-package.zip + "--TempDir": "s3://s3bucket/temp/" name: my-glue-job role: my-iam-role state: present @@ -557,6 +615,24 @@ Common return values are documented `here glueetl + +   + +
+ python_version + +
+ string +
+ + when state is present + +
Specifies the Python version.
+
+
Sample:
+
3
+ +   @@ -678,6 +754,23 @@ Common return values are documented `here + + +
+ glue_version + +
+ string +
+ + when state is present + +
Glue version.
+
+
Sample:
+
2.0
+ +
diff --git a/docs/community.aws.aws_inspector_target_module.rst b/docs/community.aws.aws_inspector_target_module.rst index 0a58c6f0f79..5a49db73b3b 100644 --- a/docs/community.aws.aws_inspector_target_module.rst +++ b/docs/community.aws.aws_inspector_target_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_kms_info_module.rst b/docs/community.aws.aws_kms_info_module.rst index 3753a1966d6..00124aaf5d6 100644 --- a/docs/community.aws.aws_kms_info_module.rst +++ b/docs/community.aws.aws_kms_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gather information about AWS KMS keys including tags and grants -- This module was called ``aws_kms_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_kms_module.rst b/docs/community.aws.aws_kms_module.rst index 3412509f0ea..08c985c5d14 100644 --- a/docs/community.aws.aws_kms_module.rst +++ b/docs/community.aws.aws_kms_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_msk_cluster_module.rst b/docs/community.aws.aws_msk_cluster_module.rst index b585d1861dc..b19886bad2f 100644 --- a/docs/community.aws.aws_msk_cluster_module.rst +++ b/docs/community.aws.aws_msk_cluster_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_msk_config_module.rst b/docs/community.aws.aws_msk_config_module.rst index 37fc97d7ac0..66f71aa027b 100644 --- a/docs/community.aws.aws_msk_config_module.rst +++ b/docs/community.aws.aws_msk_config_module.rst @@ -26,9 +26,9 @@ Requirements The below requirements are needed on the host that executes this module. - boto3 -- boto3 >= 1.15.0 +- boto3 >= 1.16.0 - botocore >= 1.17.48 -- botocore >= 1.18.0 +- botocore >= 1.19.0 - python >= 3.6 diff --git a/docs/community.aws.aws_region_info_module.rst b/docs/community.aws.aws_region_info_module.rst index 39b2d55c302..5a812bebfed 100644 --- a/docs/community.aws.aws_region_info_module.rst +++ b/docs/community.aws.aws_region_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gather information about AWS regions. -- This module was called ``aws_region_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_s3_bucket_info_module.rst b/docs/community.aws.aws_s3_bucket_info_module.rst index f004a4c533f..4949c5de2b0 100644 --- a/docs/community.aws.aws_s3_bucket_info_module.rst +++ b/docs/community.aws.aws_s3_bucket_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Lists S3 buckets and details about those buckets. -- This module was called ``aws_s3_bucket_facts`` before Ansible 2.9, returning ``ansible_facts``. Note that the :ref:`community.aws.aws_s3_bucket_info ` module no longer returns ``ansible_facts``! @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters @@ -308,7 +307,6 @@ Parameters
Retrive S3 ownership controls.
-
Access to bucket ownership controls requires botocore>=1.18.11.
diff --git a/docs/community.aws.aws_s3_cors_module.rst b/docs/community.aws.aws_s3_cors_module.rst index 03af570f9f7..ad8f384788d 100644 --- a/docs/community.aws.aws_s3_cors_module.rst +++ b/docs/community.aws.aws_s3_cors_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_secret_module.rst b/docs/community.aws.aws_secret_module.rst index c350a06e078..c832668b1ef 100644 --- a/docs/community.aws.aws_secret_module.rst +++ b/docs/community.aws.aws_secret_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_ses_identity_module.rst b/docs/community.aws.aws_ses_identity_module.rst index a439fa43a8a..09401492c9d 100644 --- a/docs/community.aws.aws_ses_identity_module.rst +++ b/docs/community.aws.aws_ses_identity_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_ses_identity_policy_module.rst b/docs/community.aws.aws_ses_identity_policy_module.rst index f97c858a62f..06123e4471d 100644 --- a/docs/community.aws.aws_ses_identity_policy_module.rst +++ b/docs/community.aws.aws_ses_identity_policy_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_ses_rule_set_module.rst b/docs/community.aws.aws_ses_rule_set_module.rst index cf4454134db..c2c748cd714 100644 --- a/docs/community.aws.aws_ses_rule_set_module.rst +++ b/docs/community.aws.aws_ses_rule_set_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_sgw_info_module.rst b/docs/community.aws.aws_sgw_info_module.rst index ee750483fe2..372fcb7ea10 100644 --- a/docs/community.aws.aws_sgw_info_module.rst +++ b/docs/community.aws.aws_sgw_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Fetch AWS Storage Gateway information -- This module was called ``aws_sgw_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_ssm_connection.rst b/docs/community.aws.aws_ssm_connection.rst index d88a1b506f6..8f0298fa339 100644 --- a/docs/community.aws.aws_ssm_connection.rst +++ b/docs/community.aws.aws_ssm_connection.rst @@ -78,6 +78,48 @@ Parameters
The name of the S3 bucket used for file transfers.
+ + +
+ bucket_sse_kms_key_id + +
+ - +
+
added in 2.2.0
+ + + + +
var: ansible_aws_ssm_bucket_sse_kms_key_id
+ + +
KMS key id to use when encrypting objects using bucket_sse_mode=aws:kms. Ignored otherwise.
+ + + + +
+ bucket_sse_mode + +
+ - +
+
added in 2.2.0
+ + +
    Choices: +
  • AES256
  • +
  • aws:kms
  • +
+ + +
var: ansible_aws_ssm_bucket_sse_mode
+ + +
Server-side encryption mode to use for uploads on the S3 bucket used for file transfer.
+ +
@@ -329,6 +371,20 @@ Examples # Execution: ansible-playbook win_file.yaml -i aws_ec2.yml # The playbook tasks will get executed on the instance ids returned from the dynamic inventory plugin using ssm connection. + # Install a Nginx Package on Linux Instance; with specific SSE for file transfer + - name: Install a Nginx Package + vars: + ansible_connection: aws_ssm + ansible_aws_ssm_bucket_name: nameofthebucket + ansible_aws_ssm_region: us-west-2 + ansible_aws_ssm_bucket_sse_mode: 'aws:kms' + ansible_aws_ssm_bucket_sse_kms_key_id: alias/kms-key-alias + tasks: + - name: Install a Nginx Package + yum: + name: nginx + state: present + diff --git a/docs/community.aws.aws_ssm_parameter_store_module.rst b/docs/community.aws.aws_ssm_parameter_store_module.rst index 76b06dcbd77..edd05041d43 100644 --- a/docs/community.aws.aws_ssm_parameter_store_module.rst +++ b/docs/community.aws.aws_ssm_parameter_store_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_step_functions_state_machine_execution_module.rst b/docs/community.aws.aws_step_functions_state_machine_execution_module.rst index 76bdb9dc4bb..9aa144d175b 100644 --- a/docs/community.aws.aws_step_functions_state_machine_execution_module.rst +++ b/docs/community.aws.aws_step_functions_state_machine_execution_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_step_functions_state_machine_module.rst b/docs/community.aws.aws_step_functions_state_machine_module.rst index 0706e8c3829..f6e3d3f0326 100644 --- a/docs/community.aws.aws_step_functions_state_machine_module.rst +++ b/docs/community.aws.aws_step_functions_state_machine_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_waf_condition_module.rst b/docs/community.aws.aws_waf_condition_module.rst index 008043e9466..94ca42cfed2 100644 --- a/docs/community.aws.aws_waf_condition_module.rst +++ b/docs/community.aws.aws_waf_condition_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_waf_info_module.rst b/docs/community.aws.aws_waf_info_module.rst index 85e18d75544..1c4858541d4 100644 --- a/docs/community.aws.aws_waf_info_module.rst +++ b/docs/community.aws.aws_waf_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Retrieve information for WAF ACLs, Rule , Conditions and Filters. -- This module was called ``aws_waf_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_waf_rule_module.rst b/docs/community.aws.aws_waf_rule_module.rst index 4a122fdc547..091f8877da2 100644 --- a/docs/community.aws.aws_waf_rule_module.rst +++ b/docs/community.aws.aws_waf_rule_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.aws_waf_web_acl_module.rst b/docs/community.aws.aws_waf_web_acl_module.rst index 117059745dd..54253129cf5 100644 --- a/docs/community.aws.aws_waf_web_acl_module.rst +++ b/docs/community.aws.aws_waf_web_acl_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.cloudformation_exports_info_module.rst b/docs/community.aws.cloudformation_exports_info_module.rst index 9bd43334bb1..41a3e9f0efb 100644 --- a/docs/community.aws.cloudformation_exports_info_module.rst +++ b/docs/community.aws.cloudformation_exports_info_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.cloudformation_stack_set_module.rst b/docs/community.aws.cloudformation_stack_set_module.rst index 1ad9dd1f311..0a5783223d2 100644 --- a/docs/community.aws.cloudformation_stack_set_module.rst +++ b/docs/community.aws.cloudformation_stack_set_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.cloudfront_distribution_module.rst b/docs/community.aws.cloudfront_distribution_module.rst index 4274b12a5cc..83584c782ae 100644 --- a/docs/community.aws.cloudfront_distribution_module.rst +++ b/docs/community.aws.cloudfront_distribution_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.cloudfront_info_module.rst b/docs/community.aws.cloudfront_info_module.rst index 882c19e9528..f5348b059a6 100644 --- a/docs/community.aws.cloudfront_info_module.rst +++ b/docs/community.aws.cloudfront_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gets information about an AWS CloudFront distribution. -- This module was called ``cloudfront_facts`` before Ansible 2.9, returning ``ansible_facts``. Note that the :ref:`community.aws.cloudfront_info ` module no longer returns ``ansible_facts``! @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters @@ -598,22 +597,6 @@ Examples - ansible.builtin.debug: msg: "{{ result_website['cloudfront']['www.my-website.com'] }}" - # When the module is called as cloudfront_facts, return values are published - # in ansible_facts['cloudfront'][] and can be used as follows. - # Note that this is deprecated and will stop working in a release after 2021-12-01. - - name: Gather facts - community.aws.cloudfront_facts: - distribution: true - distribution_id: my-cloudfront-distribution-id - - ansible.builtin.debug: - msg: "{{ ansible_facts['cloudfront']['my-cloudfront-distribution-id'] }}" - - - community.aws.cloudfront_facts: - distribution: true - domain_name_alias: www.my-website.com - - ansible.builtin.debug: - msg: "{{ ansible_facts['cloudfront']['www.my-website.com'] }}" - - name: Get all information about an invalidation for a distribution. community.aws.cloudfront_info: invalidation: true diff --git a/docs/community.aws.cloudfront_invalidation_module.rst b/docs/community.aws.cloudfront_invalidation_module.rst index 1b64c27ef53..e1d804ee565 100644 --- a/docs/community.aws.cloudfront_invalidation_module.rst +++ b/docs/community.aws.cloudfront_invalidation_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.cloudfront_origin_access_identity_module.rst b/docs/community.aws.cloudfront_origin_access_identity_module.rst index 45ffd8bb0c8..a92325f433b 100644 --- a/docs/community.aws.cloudfront_origin_access_identity_module.rst +++ b/docs/community.aws.cloudfront_origin_access_identity_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.cloudtrail_module.rst b/docs/community.aws.cloudtrail_module.rst index 3f3baa82c07..10ab8cd1786 100644 --- a/docs/community.aws.cloudtrail_module.rst +++ b/docs/community.aws.cloudtrail_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.cloudwatchevent_rule_module.rst b/docs/community.aws.cloudwatchevent_rule_module.rst index 441d276d550..254a26bfaa9 100644 --- a/docs/community.aws.cloudwatchevent_rule_module.rst +++ b/docs/community.aws.cloudwatchevent_rule_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.cloudwatchlogs_log_group_info_module.rst b/docs/community.aws.cloudwatchlogs_log_group_info_module.rst index 6206c9deba1..5eff72ca74c 100644 --- a/docs/community.aws.cloudwatchlogs_log_group_info_module.rst +++ b/docs/community.aws.cloudwatchlogs_log_group_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Lists the specified log groups. You can list all your log groups or filter the results by prefix. -- This module was called ``cloudwatchlogs_log_group_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.cloudwatchlogs_log_group_metric_filter_module.rst b/docs/community.aws.cloudwatchlogs_log_group_metric_filter_module.rst index 350ac92429c..853eaee9f48 100644 --- a/docs/community.aws.cloudwatchlogs_log_group_metric_filter_module.rst +++ b/docs/community.aws.cloudwatchlogs_log_group_metric_filter_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.cloudwatchlogs_log_group_module.rst b/docs/community.aws.cloudwatchlogs_log_group_module.rst index 17ceecb94bc..255afce8613 100644 --- a/docs/community.aws.cloudwatchlogs_log_group_module.rst +++ b/docs/community.aws.cloudwatchlogs_log_group_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.data_pipeline_module.rst b/docs/community.aws.data_pipeline_module.rst index 08740070baa..162bc211a54 100644 --- a/docs/community.aws.data_pipeline_module.rst +++ b/docs/community.aws.data_pipeline_module.rst @@ -28,8 +28,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.dms_endpoint_module.rst b/docs/community.aws.dms_endpoint_module.rst index 38fe9ee552f..82d10310ee4 100644 --- a/docs/community.aws.dms_endpoint_module.rst +++ b/docs/community.aws.dms_endpoint_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.dms_replication_subnet_group_module.rst b/docs/community.aws.dms_replication_subnet_group_module.rst index f6b208ddff4..d88cf7b5932 100644 --- a/docs/community.aws.dms_replication_subnet_group_module.rst +++ b/docs/community.aws.dms_replication_subnet_group_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.dynamodb_table_module.rst b/docs/community.aws.dynamodb_table_module.rst index 49fad9eee32..3d1db3ff25d 100644 --- a/docs/community.aws.dynamodb_table_module.rst +++ b/docs/community.aws.dynamodb_table_module.rst @@ -28,8 +28,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.dynamodb_ttl_module.rst b/docs/community.aws.dynamodb_ttl_module.rst index 50ed4076859..5f0c3f94cb6 100644 --- a/docs/community.aws.dynamodb_ttl_module.rst +++ b/docs/community.aws.dynamodb_ttl_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_ami_copy_module.rst b/docs/community.aws.ec2_ami_copy_module.rst index bb3feebab07..16a171a79dd 100644 --- a/docs/community.aws.ec2_ami_copy_module.rst +++ b/docs/community.aws.ec2_ami_copy_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_asg_info_module.rst b/docs/community.aws.ec2_asg_info_module.rst index 64df8d3cf18..878507316f5 100644 --- a/docs/community.aws.ec2_asg_info_module.rst +++ b/docs/community.aws.ec2_asg_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gather information about ec2 Auto Scaling Groups (ASGs) in AWS -- This module was called ``ec2_asg_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_asg_lifecycle_hook_module.rst b/docs/community.aws.ec2_asg_lifecycle_hook_module.rst index c093c9d89a6..df451167ab8 100644 --- a/docs/community.aws.ec2_asg_lifecycle_hook_module.rst +++ b/docs/community.aws.ec2_asg_lifecycle_hook_module.rst @@ -28,8 +28,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_asg_module.rst b/docs/community.aws.ec2_asg_module.rst index 4422e8af239..53e2510fff5 100644 --- a/docs/community.aws.ec2_asg_module.rst +++ b/docs/community.aws.ec2_asg_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.iam_module.rst b/docs/community.aws.ec2_asg_scheduled_action_module.rst similarity index 69% rename from docs/community.aws.iam_module.rst rename to docs/community.aws.ec2_asg_scheduled_action_module.rst index 1ad19f9c1ec..f8a2ee6c934 100644 --- a/docs/community.aws.iam_module.rst +++ b/docs/community.aws.ec2_asg_scheduled_action_module.rst @@ -1,30 +1,25 @@ -.. _community.aws.iam_module: +.. _community.aws.ec2_asg_scheduled_action_module: -***************** -community.aws.iam -***************** +************************************** +community.aws.ec2_asg_scheduled_action +************************************** -**Manage IAM users, groups, roles and keys** +**Create, modify and delete ASG scheduled scaling actions.** -Version added: 1.0.0 +Version added: 2.2.0 .. contents:: :local: :depth: 1 -DEPRECATED ----------- -:Removed in collection release after -:Why: The iam module is based upon a deprecated version of the AWS SDK. -:Alternative: Use :ref:`community.aws.iam_user `, :ref:`community.aws.iam_group `, :ref:`community.aws.iam_role `, :ref:`community.aws.iam_policy ` and :ref:`community.aws.iam_managed_policy ` modules. - - Synopsis -------- -- Allows for the management of IAM users, user API keys, groups, roles. +- The module will create a new scheduled action when *state=present* and no given action is found. +- The module will update a new scheduled action when *state=present* and the given action is found. +- The module will delete a new scheduled action when *state=absent* and the given action is found. @@ -32,10 +27,9 @@ Requirements ------------ The below requirements are needed on the host that executes this module. -- boto >= 2.49.0 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 - python >= 3.6 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters @@ -52,42 +46,17 @@ Parameters
- access_key_ids - -
- list - / elements=string -
- - - - -
A list of the keys that you want affected by the access_key_state parameter.
- - - - -
- access_key_state + autoscaling_group_name
string + / required
-
    Choices: -
  • create
  • -
  • remove
  • -
  • active
  • -
  • inactive
  • -
  • Create
  • -
  • Remove
  • -
  • Active
  • -
  • Inactive
  • -
-
When type is user, it creates, removes, deactivates or activates a user's access key(s). Note that actions apply only to keys specified.
+
The name of the autoscaling group to add a scheduled action to.
@@ -182,122 +151,83 @@ Parameters
- ec2_url + desired_capacity
- string -
- - - - -
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.
-

aliases: aws_endpoint_url, endpoint_url
- - - - -
- groups - -
- list - / elements=string + integer
-
A list of groups the user should belong to. When state=update, will gracefully remove groups not listed.
+
ASG desired capacity.
- iam_type + ec2_url
string - / required
-
    Choices: -
  • user
  • -
  • group
  • -
  • role
  • -
-
Type of IAM resource.
- - - - -
- key_count - -
- integer -
- - - Default:
1
- - -
When access_key_state=create it will ensure this quantity of keys are present.
+
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.
+

aliases: aws_endpoint_url, endpoint_url
- name + end_time
string - / required
-
Name of IAM resource to create or identify.
+
End time for the action.
- new_name + max_size
- string + integer
-
When state=update, will replace name with new_name on IAM resource.
+
ASG max capacity.
- new_path + min_size
- string + integer
-
When state=update, will replace the path with new_path on the IAM resource.
+
ASG min capacity.
- password + profile
string @@ -306,31 +236,31 @@ Parameters -
When type=user and either state=present or state=update, define the users login password.
-
Note that this will always return 'changed'.
+
Using profile will override aws_access_key, aws_secret_key and security_token and support for passing them at the same time as profile has been deprecated.
+
aws_access_key, aws_secret_key and security_token will be made mutually exclusive with profile after 2022-06-01.
+

aliases: aws_profile
- path + recurrence
string
- Default:
"/"
-
When creating or updating, specify the desired path of the resource.
-
If state=present, it will replace the current path to match what is passed in when they do not match.
+
Cron style schedule to repeat the action on.
+
Required when state=present.
- profile + region
string @@ -339,25 +269,24 @@ Parameters -
Using profile will override aws_access_key, aws_secret_key and security_token and support for passing them at the same time as profile has been deprecated.
-
aws_access_key, aws_secret_key and security_token will be made mutually exclusive with profile after 2022-06-01.
-

aliases: aws_profile
+
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 http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
+

aliases: aws_region, ec2_region
- region + scheduled_action_name
string + / required
-
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 http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
-

aliases: aws_region, ec2_region
+
The name of the scheduled action.
@@ -381,75 +310,50 @@ Parameters
- state + start_time
string - / required -
- - -
    Choices: -
  • present
  • -
  • absent
  • -
  • update
  • -
- - -
Whether to create, delete or update the IAM resource. Note, roles cannot be updated.
- - - - -
- trust_policy - -
- dictionary
-
The inline (JSON or YAML) trust policy document that grants an entity permission to assume the role.
-
Mutually exclusive with trust_policy_filepath.
+
Start time for the action.
- trust_policy_filepath + state
string
+
    Choices: +
  • present ←
  • +
  • absent
  • +
-
The path to the trust policy document that grants an entity permission to assume the role.
-
Mutually exclusive with trust_policy.
+
Create / update or delete scheduled action.
- update_password + time_zone
string
-
    Choices: -
  • always ←
  • -
  • on_create
  • -
-
When to update user passwords.
-
update_password=always will ensure the password is set to password.
-
update_password=on_create will only set the password for newly created users.
+
Time zone to run against.
@@ -479,7 +383,6 @@ Notes ----- .. note:: - - Currently boto does not support the removal of Managed Policies, the module will error out if your user/group/role has managed policies when you try to do state=absent. They will need to be removed manually. - 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. - Modules based on the original AWS SDK (boto) may read their default configuration from different files. See https://boto.readthedocs.io/en/latest/boto_config_tut.html for more information. @@ -492,51 +395,39 @@ Examples .. code-block:: yaml - # Basic user creation example - - name: Create two new IAM users with API keys - community.aws.iam: - iam_type: user - name: "{{ item }}" + # Create a scheduled action for a autoscaling group. + - name: Create a minimal scheduled action for autoscaling group + community.aws.ec2_asg_scheduled_action: + region: eu-west-1 + autoscaling_group_name: test_asg + scheduled_action_name: test_scheduled_action + start_time: 2021 October 25 08:00 UTC + recurrence: 40 22 * * 1-5 + desired_capacity: 10 state: present - password: "{{ temp_pass }}" - access_key_state: create - loop: - - jcleese - - mpython - - # Advanced example, create two new groups and add the pre-existing user - # jdavila to both groups. - - name: Create Two Groups, Mario and Luigi - community.aws.iam: - iam_type: group - name: "{{ item }}" + register: scheduled_action + + - name: Create a scheduled action for autoscaling group + community.aws.ec2_asg_scheduled_action: + region: eu-west-1 + autoscaling_group_name: test_asg + scheduled_action_name: test_scheduled_action + start_time: 2021 October 25 08:00 UTC + end_time: 2021 October 25 08:00 UTC + time_zone: Europe/London + recurrence: 40 22 * * 1-5 + min_size: 10 + max_size: 15 + desired_capacity: 10 state: present - loop: - - Mario - - Luigi - register: new_groups - - - name: Update user - community.aws.iam: - iam_type: user - name: jdavila - state: update - groups: "{{ item.created_group.group_name }}" - loop: "{{ new_groups.results }}" - - # Example of role with custom trust policy for Lambda service - - name: Create IAM role with custom trust relationship - community.aws.iam: - iam_type: role - name: AAALambdaTestRole - state: present - trust_policy: - Version: '2012-10-17' - Statement: - - Action: sts:AssumeRole - Effect: Allow - Principal: - Service: lambda.amazonaws.com + register: scheduled_action + + - name: Delete scheduled action + community.aws.ec2_asg_scheduled_action: + region: eu-west-1 + autoscaling_group_name: test_asg + scheduled_action_name: test_scheduled_action + state: absent @@ -555,35 +446,137 @@ Common return values are documented `here
- role_result + desired_capacity + +
+ integer +
+ + when state=present + +
ASG desired capacity.
+
+
Sample:
+
1
+ + + + +
+ end_time
string
- if iam_type=role and state=present + when state=present -
the IAM.role dict returned by Boto
+
End time for the action.

Sample:
-
{'arn': 'arn:aws:iam::A1B2C3D4E5F6:role/my-new-role', 'assume_role_policy_document': '...truncated...', 'create_date': '2017-09-02T14:32:23Z', 'path': '/', 'role_id': 'AROAA1B2C3D4E5F6G7H8I', 'role_name': 'my-new-role'}
+
2021 October 25 08:00 UTC
- roles + max_size
- list + integer
- if iam_type=role and state=present + when state=present -
a list containing the name of the currently defined roles
+
ASG max capacity.

Sample:
-
['my-new-role', 'my-existing-role-1', 'my-existing-role-2', 'my-existing-role-3', 'my-existing-role-...']
+
2
+ + + + +
+ min_size + +
+ integer +
+ + when state=present + +
ASG min capacity.
+
+
Sample:
+
1
+ + + + +
+ recurrence + +
+ string +
+ + when state=present + +
Cron style schedule to repeat the action on.
+
+
Sample:
+
40 22 * * 1-5
+ + + + +
+ scheduled_action_name + +
+ string +
+ + when state=present + +
The name of the scheduled action.
+
+
Sample:
+
test_scheduled_action
+ + + + +
+ start_time + +
+ string +
+ + when state=present + +
Start time for the action.
+
+
Sample:
+
2021 October 25 08:00 UTC
+ + + + +
+ time_zone + +
+ string +
+ + when state=present + +
The ID of the Amazon Machine Image used by the launch configuration.
+
+
Sample:
+
Europe/London
@@ -594,12 +587,7 @@ Status ------ -- This module will be removed in version 3.0.0. *[deprecated]* -- For more information see `DEPRECATED`_. - - Authors ~~~~~~~ -- Jonathan I. Davila (@defionscode) -- Paul Seiffert (@seiffert) +- Mark Woolley(@marknet15) diff --git a/docs/community.aws.ec2_customer_gateway_info_module.rst b/docs/community.aws.ec2_customer_gateway_info_module.rst index 8034b96949c..f12e9f5f584 100644 --- a/docs/community.aws.ec2_customer_gateway_info_module.rst +++ b/docs/community.aws.ec2_customer_gateway_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gather information about customer gateways in AWS. -- This module was called ``ec2_customer_gateway_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_customer_gateway_module.rst b/docs/community.aws.ec2_customer_gateway_module.rst index a38ee5dfe0c..a4c47163564 100644 --- a/docs/community.aws.ec2_customer_gateway_module.rst +++ b/docs/community.aws.ec2_customer_gateway_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_eip_info_module.rst b/docs/community.aws.ec2_eip_info_module.rst index 2cfcd570736..7a5614abccd 100644 --- a/docs/community.aws.ec2_eip_info_module.rst +++ b/docs/community.aws.ec2_eip_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - List details of EC2 Elastic IP addresses. -- This module was called ``ec2_eip_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_eip_module.rst b/docs/community.aws.ec2_eip_module.rst index bb9f8238bf2..cacfa7fa2d3 100644 --- a/docs/community.aws.ec2_eip_module.rst +++ b/docs/community.aws.ec2_eip_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_elb_info_module.rst b/docs/community.aws.ec2_elb_info_module.rst deleted file mode 100644 index a9d8888db6b..00000000000 --- a/docs/community.aws.ec2_elb_info_module.rst +++ /dev/null @@ -1,308 +0,0 @@ -.. _community.aws.ec2_elb_info_module: - - -************************** -community.aws.ec2_elb_info -************************** - -**Gather information about EC2 Elastic Load Balancers in AWS** - - -Version added: 1.0.0 - -.. contents:: - :local: - :depth: 1 - -DEPRECATED ----------- -:Removed in collection release after -:Why: The ec2_elb_info is based upon a deprecated version of the AWS SDK. -:Alternative: Use :ref:`community.aws.elb_classic_lb_info `. - - - -Synopsis --------- -- Gather information about EC2 Elastic Load Balancers in AWS -- This module was called ``ec2_elb_facts`` before Ansible 2.9. The usage did not change. - - - -Requirements ------------- -The below requirements are needed on the host that executes this module. - -- boto >= 2.49.0 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 -- python >= 3.6 - - -Parameters ----------- - -.. raw:: html - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ParameterChoices/DefaultsComments
-
- aws_access_key - -
- string -
-
- -
AWS access key. If not set then the value of the AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY or EC2_ACCESS_KEY environment variable is used.
-
If profile is set this parameter is ignored.
-
Passing the aws_access_key and profile options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01.
-

aliases: ec2_access_key, access_key
-
-
- aws_ca_bundle - -
- path -
-
- -
The location of a CA Bundle to use when validating SSL certificates.
-
Not used by boto 2 based modules.
-
Note: The CA Bundle is read 'module' side and may need to be explicitly copied from the controller if not run locally.
-
-
- aws_config - -
- dictionary -
-
- -
A dictionary to modify the botocore configuration.
- -
Only the 'user_agent' key is used for boto modules. See http://boto.cloudhackers.com/en/latest/boto_config_tut.html#boto for more boto configuration.
-
-
- aws_secret_key - -
- string -
-
- -
AWS secret key. If not set then the value of the AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY, or EC2_SECRET_KEY environment variable is used.
-
If profile is set this parameter is ignored.
-
Passing the aws_secret_key and profile options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01.
-

aliases: ec2_secret_key, secret_key
-
-
- debug_botocore_endpoint_logs - -
- boolean -
-
-
    Choices: -
  • no ←
  • -
  • yes
  • -
-
-
Use a botocore.endpoint logger to parse the unique (rather than total) "resource:action" 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.
-
-
- ec2_url - -
- string -
-
- -
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.
-

aliases: aws_endpoint_url, endpoint_url
-
-
- names - -
- list - / elements=string -
-
- -
List of ELB names to gather information about. Pass this option to gather information about a set of ELBs, otherwise, all ELBs are returned.
-
-
- profile - -
- string -
-
- -
Using profile will override aws_access_key, aws_secret_key and security_token and support for passing them at the same time as profile has been deprecated.
-
aws_access_key, aws_secret_key and security_token will be made mutually exclusive with profile after 2022-06-01.
-

aliases: aws_profile
-
-
- region - -
- string -
-
- -
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 http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
-

aliases: aws_region, ec2_region
-
-
- security_token - -
- string -
-
- -
AWS STS security token. If not set then the value of the AWS_SECURITY_TOKEN or EC2_SECURITY_TOKEN environment variable is used.
-
If profile is set this parameter is ignored.
-
Passing the security_token and profile options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01.
-

aliases: aws_security_token, access_token
-
-
- validate_certs - -
- boolean -
-
-
    Choices: -
  • no
  • -
  • yes ←
  • -
-
-
When set to "no", SSL certificates will not be validated for communication with the AWS APIs.
-
-
- - -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. - - Modules based on the original AWS SDK (boto) may read their default configuration from different files. See https://boto.readthedocs.io/en/latest/boto_config_tut.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. - # Output format tries to match amazon.aws.ec2_elb_lb module input parameters - - - name: Gather information about all ELBs - community.aws.ec2_elb_info: - register: elb_info - - ansible.builtin.debug: - msg: "{{ item.dns_name }}" - loop: "{{ elb_info.elbs }}" - - - name: Gather information about a particular ELB - community.aws.ec2_elb_info: - names: frontend-prod-elb - register: elb_info - - - ansible.builtin.debug: - msg: "{{ elb_info.elbs.0.dns_name }}" - - - name: Gather information about a set of ELBs - community.aws.ec2_elb_info: - names: - - frontend-prod-elb - - backend-prod-elb - register: elb_info - - - ansible.builtin.debug: - msg: "{{ item.dns_name }}" - loop: "{{ elb_info.elbs }}" - - - - -Status ------- - - -- This module will be removed in version 3.0.0. *[deprecated]* -- For more information see `DEPRECATED`_. - - -Authors -~~~~~~~ - -- Michael Schultz (@mjschultz) -- Fernando Jose Pando (@nand0p) diff --git a/docs/community.aws.ec2_launch_template_module.rst b/docs/community.aws.ec2_launch_template_module.rst index 0df31038a64..b8578514e88 100644 --- a/docs/community.aws.ec2_launch_template_module.rst +++ b/docs/community.aws.ec2_launch_template_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_lc_find_module.rst b/docs/community.aws.ec2_lc_find_module.rst index b63f45c59f9..2603ae037a3 100644 --- a/docs/community.aws.ec2_lc_find_module.rst +++ b/docs/community.aws.ec2_lc_find_module.rst @@ -28,8 +28,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_lc_info_module.rst b/docs/community.aws.ec2_lc_info_module.rst index c69ad922727..b78cad69905 100644 --- a/docs/community.aws.ec2_lc_info_module.rst +++ b/docs/community.aws.ec2_lc_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gather information about AWS Autoscaling Launch Configurations. -- This module was called ``ec2_lc_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_lc_module.rst b/docs/community.aws.ec2_lc_module.rst index 2acba0c3904..4041ad29759 100644 --- a/docs/community.aws.ec2_lc_module.rst +++ b/docs/community.aws.ec2_lc_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_metric_alarm_module.rst b/docs/community.aws.ec2_metric_alarm_module.rst index d55e599ddc7..a83000d36a2 100644 --- a/docs/community.aws.ec2_metric_alarm_module.rst +++ b/docs/community.aws.ec2_metric_alarm_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_placement_group_info_module.rst b/docs/community.aws.ec2_placement_group_info_module.rst index afc05c66621..e78e580335f 100644 --- a/docs/community.aws.ec2_placement_group_info_module.rst +++ b/docs/community.aws.ec2_placement_group_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - List details of EC2 Placement Group(s). -- This module was called ``ec2_placement_group_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_placement_group_module.rst b/docs/community.aws.ec2_placement_group_module.rst index eda2dffdb8e..7c17cc0c1f8 100644 --- a/docs/community.aws.ec2_placement_group_module.rst +++ b/docs/community.aws.ec2_placement_group_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_scaling_policy_module.rst b/docs/community.aws.ec2_scaling_policy_module.rst index a5a0ac17605..fc9ae46e9ab 100644 --- a/docs/community.aws.ec2_scaling_policy_module.rst +++ b/docs/community.aws.ec2_scaling_policy_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_snapshot_copy_module.rst b/docs/community.aws.ec2_snapshot_copy_module.rst index 9f93e140860..de0984d4be0 100644 --- a/docs/community.aws.ec2_snapshot_copy_module.rst +++ b/docs/community.aws.ec2_snapshot_copy_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_transit_gateway_info_module.rst b/docs/community.aws.ec2_transit_gateway_info_module.rst index 27c90dc71ac..d76a54f7fff 100644 --- a/docs/community.aws.ec2_transit_gateway_info_module.rst +++ b/docs/community.aws.ec2_transit_gateway_info_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_transit_gateway_module.rst b/docs/community.aws.ec2_transit_gateway_module.rst index 18f76c66a2d..b82648991b5 100644 --- a/docs/community.aws.ec2_transit_gateway_module.rst +++ b/docs/community.aws.ec2_transit_gateway_module.rst @@ -28,8 +28,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_vpc_egress_igw_module.rst b/docs/community.aws.ec2_vpc_egress_igw_module.rst index 4043cf775d6..3c0a49166a4 100644 --- a/docs/community.aws.ec2_vpc_egress_igw_module.rst +++ b/docs/community.aws.ec2_vpc_egress_igw_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_vpc_nacl_info_module.rst b/docs/community.aws.ec2_vpc_nacl_info_module.rst index e690d470631..22ee1c3b425 100644 --- a/docs/community.aws.ec2_vpc_nacl_info_module.rst +++ b/docs/community.aws.ec2_vpc_nacl_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gather information about Network ACLs in an AWS VPC -- This module was called ``ec2_vpc_nacl_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_vpc_nacl_module.rst b/docs/community.aws.ec2_vpc_nacl_module.rst index 329f218f0bc..46bf7c1ed8f 100644 --- a/docs/community.aws.ec2_vpc_nacl_module.rst +++ b/docs/community.aws.ec2_vpc_nacl_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_vpc_peer_module.rst b/docs/community.aws.ec2_vpc_peer_module.rst index f6183111a62..ba2b087a72d 100644 --- a/docs/community.aws.ec2_vpc_peer_module.rst +++ b/docs/community.aws.ec2_vpc_peer_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_vpc_peering_info_module.rst b/docs/community.aws.ec2_vpc_peering_info_module.rst index c23282c99b1..0f872700904 100644 --- a/docs/community.aws.ec2_vpc_peering_info_module.rst +++ b/docs/community.aws.ec2_vpc_peering_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gets various details related to AWS VPC Peers -- This module was called ``ec2_vpc_peering_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_vpc_route_table_info_module.rst b/docs/community.aws.ec2_vpc_route_table_info_module.rst index 59976e4a317..6c025276cdd 100644 --- a/docs/community.aws.ec2_vpc_route_table_info_module.rst +++ b/docs/community.aws.ec2_vpc_route_table_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gather information about ec2 VPC route tables in AWS -- This module was called ``ec2_vpc_route_table_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_vpc_route_table_module.rst b/docs/community.aws.ec2_vpc_route_table_module.rst index 0468df68e68..ad82db6dc69 100644 --- a/docs/community.aws.ec2_vpc_route_table_module.rst +++ b/docs/community.aws.ec2_vpc_route_table_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_vpc_vgw_info_module.rst b/docs/community.aws.ec2_vpc_vgw_info_module.rst index 307b0fa3046..ff5fe83dd9a 100644 --- a/docs/community.aws.ec2_vpc_vgw_info_module.rst +++ b/docs/community.aws.ec2_vpc_vgw_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gather information about virtual gateways in AWS. -- This module was called ``ec2_vpc_vgw_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_vpc_vgw_module.rst b/docs/community.aws.ec2_vpc_vgw_module.rst index 5da685210ba..b2f79d74467 100644 --- a/docs/community.aws.ec2_vpc_vgw_module.rst +++ b/docs/community.aws.ec2_vpc_vgw_module.rst @@ -29,8 +29,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_vpc_vpn_info_module.rst b/docs/community.aws.ec2_vpc_vpn_info_module.rst index be6c5130e75..fbf5aa8bded 100644 --- a/docs/community.aws.ec2_vpc_vpn_info_module.rst +++ b/docs/community.aws.ec2_vpc_vpn_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gather information about VPN Connections in AWS. -- This module was called ``ec2_vpc_vpn_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_vpc_vpn_module.rst b/docs/community.aws.ec2_vpc_vpn_module.rst index b6dd8e5e6cb..41e63c77d02 100644 --- a/docs/community.aws.ec2_vpc_vpn_module.rst +++ b/docs/community.aws.ec2_vpc_vpn_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ec2_win_password_module.rst b/docs/community.aws.ec2_win_password_module.rst index c48180a2a4c..4a1dbaf0138 100644 --- a/docs/community.aws.ec2_win_password_module.rst +++ b/docs/community.aws.ec2_win_password_module.rst @@ -25,8 +25,8 @@ Requirements ------------ The below requirements are needed on the host that executes this module. -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 - cryptography - python >= 3.6 diff --git a/docs/community.aws.ecs_attribute_module.rst b/docs/community.aws.ecs_attribute_module.rst index 5948d4227bc..361dec81081 100644 --- a/docs/community.aws.ecs_attribute_module.rst +++ b/docs/community.aws.ecs_attribute_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ecs_cluster_module.rst b/docs/community.aws.ecs_cluster_module.rst index d7f56836de7..be911836938 100644 --- a/docs/community.aws.ecs_cluster_module.rst +++ b/docs/community.aws.ecs_cluster_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ecs_ecr_module.rst b/docs/community.aws.ecs_ecr_module.rst index 8227a7a7e0e..ed34a339d84 100644 --- a/docs/community.aws.ecs_ecr_module.rst +++ b/docs/community.aws.ecs_ecr_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ecs_service_info_module.rst b/docs/community.aws.ecs_service_info_module.rst index 39b3f073f96..8ac1c64d3c8 100644 --- a/docs/community.aws.ecs_service_info_module.rst +++ b/docs/community.aws.ecs_service_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Lists or describes services in ECS. -- This module was called ``ecs_service_facts`` before Ansible 2.9, returning ``ansible_facts``. Note that the :ref:`community.aws.ecs_service_info ` module no longer returns ``ansible_facts``! @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ecs_service_module.rst b/docs/community.aws.ecs_service_module.rst index d97a19d896f..511142deeb0 100644 --- a/docs/community.aws.ecs_service_module.rst +++ b/docs/community.aws.ecs_service_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ecs_tag_module.rst b/docs/community.aws.ecs_tag_module.rst index d3b69c383ea..bd2af4fbcd1 100644 --- a/docs/community.aws.ecs_tag_module.rst +++ b/docs/community.aws.ecs_tag_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ecs_task_module.rst b/docs/community.aws.ecs_task_module.rst index 5847ab1df45..ddddc1bcb80 100644 --- a/docs/community.aws.ecs_task_module.rst +++ b/docs/community.aws.ecs_task_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.ecs_taskdefinition_info_module.rst b/docs/community.aws.ecs_taskdefinition_info_module.rst index efb12e4debf..972444abb20 100644 --- a/docs/community.aws.ecs_taskdefinition_info_module.rst +++ b/docs/community.aws.ecs_taskdefinition_info_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters @@ -241,7 +241,6 @@ Notes .. note:: - For details of the parameters and returns see http://boto3.readthedocs.io/en/latest/reference/services/ecs.html#ECS.Client.describe_task_definition - - This module was called ``ecs_taskdefinition_facts`` before Ansible 2.9. The usage did not change. - 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. - Modules based on the original AWS SDK (boto) may read their default configuration from different files. See https://boto.readthedocs.io/en/latest/boto_config_tut.html for more information. diff --git a/docs/community.aws.ecs_taskdefinition_module.rst b/docs/community.aws.ecs_taskdefinition_module.rst index 4c64117d7a2..b555619364d 100644 --- a/docs/community.aws.ecs_taskdefinition_module.rst +++ b/docs/community.aws.ecs_taskdefinition_module.rst @@ -26,9 +26,9 @@ Requirements The below requirements are needed on the host that executes this module. - boto3 -- boto3 >= 1.15.0 +- boto3 >= 1.16.0 - botocore -- botocore >= 1.18.0 +- botocore >= 1.19.0 - json - python >= 3.6 diff --git a/docs/community.aws.efs_info_module.rst b/docs/community.aws.efs_info_module.rst index ebe311c9ec4..25831239c3f 100644 --- a/docs/community.aws.efs_info_module.rst +++ b/docs/community.aws.efs_info_module.rst @@ -17,8 +17,7 @@ Version added: 1.0.0 Synopsis -------- -- This module can be used to search Amazon EFS file systems. -- This module was called ``efs_facts`` before Ansible 2.9, returning ``ansible_facts``. Note that the :ref:`community.aws.efs_info ` module no longer returns ``ansible_facts``! +- This module can be used to search Amazon EFS file systems. Note that the :ref:`community.aws.efs_info ` module no longer returns ``ansible_facts``! @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.efs_module.rst b/docs/community.aws.efs_module.rst index 1fd9ff81a30..92e6fef6493 100644 --- a/docs/community.aws.efs_module.rst +++ b/docs/community.aws.efs_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.efs_tag_module.rst b/docs/community.aws.efs_tag_module.rst index 838b239d74f..33c03f40204 100644 --- a/docs/community.aws.efs_tag_module.rst +++ b/docs/community.aws.efs_tag_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.elasticache_info_module.rst b/docs/community.aws.elasticache_info_module.rst index 775b3d36441..013b434b066 100644 --- a/docs/community.aws.elasticache_info_module.rst +++ b/docs/community.aws.elasticache_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Retrieve information from AWS ElastiCache clusters -- This module was called ``elasticache_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.elasticache_module.rst b/docs/community.aws.elasticache_module.rst index eb3c8e43697..7bec854fee7 100644 --- a/docs/community.aws.elasticache_module.rst +++ b/docs/community.aws.elasticache_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.elasticache_parameter_group_module.rst b/docs/community.aws.elasticache_parameter_group_module.rst index 3f93a6865e5..18c49da7641 100644 --- a/docs/community.aws.elasticache_parameter_group_module.rst +++ b/docs/community.aws.elasticache_parameter_group_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.elasticache_snapshot_module.rst b/docs/community.aws.elasticache_snapshot_module.rst index 28218326b5e..1dbe4051b9f 100644 --- a/docs/community.aws.elasticache_snapshot_module.rst +++ b/docs/community.aws.elasticache_snapshot_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.elasticache_subnet_group_module.rst b/docs/community.aws.elasticache_subnet_group_module.rst index 260f6a84026..4070d3c19c9 100644 --- a/docs/community.aws.elasticache_subnet_group_module.rst +++ b/docs/community.aws.elasticache_subnet_group_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.elb_application_lb_info_module.rst b/docs/community.aws.elb_application_lb_info_module.rst index d511a3ddc24..e6f3cf63a18 100644 --- a/docs/community.aws.elb_application_lb_info_module.rst +++ b/docs/community.aws.elb_application_lb_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gather information about application ELBs in AWS -- This module was called ``elb_application_lb_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.elb_application_lb_module.rst b/docs/community.aws.elb_application_lb_module.rst index 020d3b34212..77b9a4da64f 100644 --- a/docs/community.aws.elb_application_lb_module.rst +++ b/docs/community.aws.elb_application_lb_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.elb_classic_lb_info_module.rst b/docs/community.aws.elb_classic_lb_info_module.rst index fcc2bc01b6b..723d7b5aaa4 100644 --- a/docs/community.aws.elb_classic_lb_info_module.rst +++ b/docs/community.aws.elb_classic_lb_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gather information about EC2 Elastic Load Balancers in AWS -- This module was called ``elb_classic_lb_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.elb_instance_module.rst b/docs/community.aws.elb_instance_module.rst index 34952e99aa6..4b6e79fa888 100644 --- a/docs/community.aws.elb_instance_module.rst +++ b/docs/community.aws.elb_instance_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.elb_network_lb_module.rst b/docs/community.aws.elb_network_lb_module.rst index 39af875a4ac..d2e7e6ba31a 100644 --- a/docs/community.aws.elb_network_lb_module.rst +++ b/docs/community.aws.elb_network_lb_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.elb_target_group_info_module.rst b/docs/community.aws.elb_target_group_info_module.rst index 3d300df03d3..b5453f14c47 100644 --- a/docs/community.aws.elb_target_group_info_module.rst +++ b/docs/community.aws.elb_target_group_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gather information about ELB target groups in AWS -- This module was called ``elb_target_group_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.elb_target_group_module.rst b/docs/community.aws.elb_target_group_module.rst index e1f947db36d..28430c63f69 100644 --- a/docs/community.aws.elb_target_group_module.rst +++ b/docs/community.aws.elb_target_group_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.elb_target_info_module.rst b/docs/community.aws.elb_target_info_module.rst index 39b55cf4a69..d2898313623 100644 --- a/docs/community.aws.elb_target_info_module.rst +++ b/docs/community.aws.elb_target_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - This module will search through every target group in a region to find which ones have registered a given instance ID or IP. -- This module was called ``elb_target_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.elb_target_module.rst b/docs/community.aws.elb_target_module.rst index 450e470048f..82893b41cd3 100644 --- a/docs/community.aws.elb_target_module.rst +++ b/docs/community.aws.elb_target_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.execute_lambda_module.rst b/docs/community.aws.execute_lambda_module.rst index 5f6f70fd960..baaa304c7e6 100644 --- a/docs/community.aws.execute_lambda_module.rst +++ b/docs/community.aws.execute_lambda_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.iam_access_key_info_module.rst b/docs/community.aws.iam_access_key_info_module.rst index 3865741b78c..bd075581397 100644 --- a/docs/community.aws.iam_access_key_info_module.rst +++ b/docs/community.aws.iam_access_key_info_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.iam_access_key_module.rst b/docs/community.aws.iam_access_key_module.rst index 44048f8fda7..07ae69d7817 100644 --- a/docs/community.aws.iam_access_key_module.rst +++ b/docs/community.aws.iam_access_key_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.iam_group_module.rst b/docs/community.aws.iam_group_module.rst index 90c97b2c894..4a630b93aa8 100644 --- a/docs/community.aws.iam_group_module.rst +++ b/docs/community.aws.iam_group_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.iam_managed_policy_module.rst b/docs/community.aws.iam_managed_policy_module.rst index d5f9878f4a3..337b2f13edc 100644 --- a/docs/community.aws.iam_managed_policy_module.rst +++ b/docs/community.aws.iam_managed_policy_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.iam_mfa_device_info_module.rst b/docs/community.aws.iam_mfa_device_info_module.rst index 2d679b95a89..4dc8cc7cdf7 100644 --- a/docs/community.aws.iam_mfa_device_info_module.rst +++ b/docs/community.aws.iam_mfa_device_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - List the MFA (Multi-Factor Authentication) devices registered for a user -- This module was called ``iam_mfa_device_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.iam_password_policy_module.rst b/docs/community.aws.iam_password_policy_module.rst index 593be87d97f..38091ba8b9e 100644 --- a/docs/community.aws.iam_password_policy_module.rst +++ b/docs/community.aws.iam_password_policy_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.iam_policy_info_module.rst b/docs/community.aws.iam_policy_info_module.rst index 1c3361febd1..d49c5ff6d2c 100644 --- a/docs/community.aws.iam_policy_info_module.rst +++ b/docs/community.aws.iam_policy_info_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.iam_policy_module.rst b/docs/community.aws.iam_policy_module.rst index ed654a7cfe5..83347730bec 100644 --- a/docs/community.aws.iam_policy_module.rst +++ b/docs/community.aws.iam_policy_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.iam_role_info_module.rst b/docs/community.aws.iam_role_info_module.rst index d7de4a0837d..f5f83a69ccf 100644 --- a/docs/community.aws.iam_role_info_module.rst +++ b/docs/community.aws.iam_role_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gathers information about IAM roles. -- This module was called ``iam_role_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.iam_role_module.rst b/docs/community.aws.iam_role_module.rst index b8804888bfb..eab0244a87d 100644 --- a/docs/community.aws.iam_role_module.rst +++ b/docs/community.aws.iam_role_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.iam_saml_federation_module.rst b/docs/community.aws.iam_saml_federation_module.rst index 785b1509c4b..d31f15848f8 100644 --- a/docs/community.aws.iam_saml_federation_module.rst +++ b/docs/community.aws.iam_saml_federation_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.iam_server_certificate_info_module.rst b/docs/community.aws.iam_server_certificate_info_module.rst index 1f81ea21f74..0a3949e5bb3 100644 --- a/docs/community.aws.iam_server_certificate_info_module.rst +++ b/docs/community.aws.iam_server_certificate_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Retrieve the attributes of a server certificate. -- This module was called ``iam_server_certificate_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.iam_server_certificate_module.rst b/docs/community.aws.iam_server_certificate_module.rst index e4a1451e5d4..1de944cc42b 100644 --- a/docs/community.aws.iam_server_certificate_module.rst +++ b/docs/community.aws.iam_server_certificate_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - boto >= 2.49.0 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 - python >= 3.6 diff --git a/docs/community.aws.iam_user_info_module.rst b/docs/community.aws.iam_user_info_module.rst index 2b90fd57575..2b192883b81 100644 --- a/docs/community.aws.iam_user_info_module.rst +++ b/docs/community.aws.iam_user_info_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters @@ -285,17 +285,17 @@ Examples # Note: These examples do not set authentication details, see the AWS Guide for details. # Gather facts about "test" user. - - name: Get IAM user facts + - name: Get IAM user info community.aws.iam_user_info: name: "test" # Gather facts about all users in the "dev" group. - - name: Get IAM user facts + - name: Get IAM user info community.aws.iam_user_info: group: "dev" # Gather facts about all users with "/division_abc/subdivision_xyz/" path. - - name: Get IAM user facts + - name: Get IAM user info community.aws.iam_user_info: path: "/division_abc/subdivision_xyz/" diff --git a/docs/community.aws.iam_user_module.rst b/docs/community.aws.iam_user_module.rst index c596e3279be..c291252be0c 100644 --- a/docs/community.aws.iam_user_module.rst +++ b/docs/community.aws.iam_user_module.rst @@ -17,7 +17,8 @@ Version added: 1.0.0 Synopsis -------- -- Manage AWS IAM users. +- A module to manage AWS IAM users. +- The module does not manage groups that users belong to, groups memberships can be managed using `iam_group`. @@ -26,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters @@ -180,6 +181,22 @@ Parameters
The name of the user to create.
+ + +
+ password + +
+ string +
+
added in 2.2.0
+ + + + +
The password to apply to the user.
+ +
@@ -213,7 +230,7 @@ Parameters -
When purge_policies=true any managed policies not listed in managed_policies will be detatched.
+
When purge_policies=true any managed policies not listed in managed_policies will be detached.

aliases: purge_policy, purge_managed_policies
@@ -253,6 +270,27 @@ Parameters

aliases: aws_region, ec2_region
+ + +
+ remove_password + +
+ boolean +
+
added in 2.2.0
+ + +
    Choices: +
  • no
  • +
  • yes
  • +
+ + +
Option to delete user login passwords.
+
This field is mutually exclusive to password.
+ +
@@ -307,6 +345,28 @@ Parameters
Tag dict to apply to the user.
+ + +
+ update_password + +
+ string +
+
added in 2.2.0
+ + +
    Choices: +
  • always ←
  • +
  • on_create
  • +
+ + +
When to update user passwords.
+
update_password=always will ensure the password is set to password.
+
update_password=on_create will only set the password for newly created users.
+ +
@@ -326,6 +386,43 @@ Parameters
When set to "no", SSL certificates will not be validated for communication with the AWS APIs.
+ + +
+ wait + +
+ boolean +
+
added in 2.2.0
+ + +
    Choices: +
  • no
  • +
  • yes ←
  • +
+ + +
When wait=True the module will wait for up to wait_timeout seconds for IAM user creation before returning.
+ + + + +
+ wait_timeout + +
+ integer +
+
added in 2.2.0
+ + + Default:
120
+ + +
How long (in seconds) to wait for creation / updates to complete.
+ +
@@ -356,6 +453,12 @@ Examples name: testuser1 state: present + - name: Create a user with a password + community.aws.iam_user: + name: testuser1 + password: SomeSecurePassword + state: present + - name: Create a user and attach a managed policy using its ARN community.aws.iam_user: name: testuser1 diff --git a/docs/community.aws.kinesis_stream_module.rst b/docs/community.aws.kinesis_stream_module.rst index 51ed5640cb0..eb8e1970496 100644 --- a/docs/community.aws.kinesis_stream_module.rst +++ b/docs/community.aws.kinesis_stream_module.rst @@ -29,8 +29,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.lambda_alias_module.rst b/docs/community.aws.lambda_alias_module.rst index 6d0acd53328..205a8cca114 100644 --- a/docs/community.aws.lambda_alias_module.rst +++ b/docs/community.aws.lambda_alias_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.lambda_event_module.rst b/docs/community.aws.lambda_event_module.rst index 14c0f6d008c..b03465d8bf5 100644 --- a/docs/community.aws.lambda_event_module.rst +++ b/docs/community.aws.lambda_event_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.lambda_facts_module.rst b/docs/community.aws.lambda_facts_module.rst deleted file mode 100644 index 8abc4cb5149..00000000000 --- a/docs/community.aws.lambda_facts_module.rst +++ /dev/null @@ -1,398 +0,0 @@ -.. _community.aws.lambda_facts_module: - - -************************** -community.aws.lambda_facts -************************** - -**Gathers AWS Lambda function details as Ansible facts** - - -Version added: 1.0.0 - -.. contents:: - :local: - :depth: 1 - -DEPRECATED ----------- -:Removed in collection release after 2021-12-01 -:Why: Deprecated in favour of ``_info`` module. -:Alternative: Use :ref:`community.aws.lambda_info ` instead. - - - -Synopsis --------- -- Gathers various details related to Lambda functions, including aliases, versions and event source mappings. Use module :ref:`community.aws.lambda ` to manage the lambda function itself, :ref:`community.aws.lambda_alias ` to manage function aliases and :ref:`community.aws.lambda_event ` to manage lambda event source mappings. - - - -Requirements ------------- -The below requirements are needed on the host that executes this module. - -- python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 - - -Parameters ----------- - -.. raw:: html - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ParameterChoices/DefaultsComments
-
- aws_access_key - -
- string -
-
- -
AWS access key. If not set then the value of the AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY or EC2_ACCESS_KEY environment variable is used.
-
If profile is set this parameter is ignored.
-
Passing the aws_access_key and profile options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01.
-

aliases: ec2_access_key, access_key
-
-
- aws_ca_bundle - -
- path -
-
- -
The location of a CA Bundle to use when validating SSL certificates.
-
Not used by boto 2 based modules.
-
Note: The CA Bundle is read 'module' side and may need to be explicitly copied from the controller if not run locally.
-
-
- aws_config - -
- dictionary -
-
- -
A dictionary to modify the botocore configuration.
- -
Only the 'user_agent' key is used for boto modules. See http://boto.cloudhackers.com/en/latest/boto_config_tut.html#boto for more boto configuration.
-
-
- aws_secret_key - -
- string -
-
- -
AWS secret key. If not set then the value of the AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY, or EC2_SECRET_KEY environment variable is used.
-
If profile is set this parameter is ignored.
-
Passing the aws_secret_key and profile options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01.
-

aliases: ec2_secret_key, secret_key
-
-
- debug_botocore_endpoint_logs - -
- boolean -
-
-
    Choices: -
  • no ←
  • -
  • yes
  • -
-
-
Use a botocore.endpoint logger to parse the unique (rather than total) "resource:action" 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.
-
-
- ec2_url - -
- string -
-
- -
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.
-

aliases: aws_endpoint_url, endpoint_url
-
-
- event_source_arn - -
- string -
-
- -
For query type 'mappings', this is the Amazon Resource Name (ARN) of the Amazon Kinesis or DynamoDB stream.
-
-
- function_name - -
- string -
-
- -
The name of the lambda function for which facts are requested.
-

aliases: function, name
-
-
- profile - -
- string -
-
- -
Using profile will override aws_access_key, aws_secret_key and security_token and support for passing them at the same time as profile has been deprecated.
-
aws_access_key, aws_secret_key and security_token will be made mutually exclusive with profile after 2022-06-01.
-

aliases: aws_profile
-
-
- query - -
- string -
-
-
    Choices: -
  • aliases
  • -
  • all ←
  • -
  • config
  • -
  • mappings
  • -
  • policy
  • -
  • versions
  • -
-
-
Specifies the resource type for which to gather facts. Leave blank to retrieve all facts.
-
-
- region - -
- string -
-
- -
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 http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
-

aliases: aws_region, ec2_region
-
-
- security_token - -
- string -
-
- -
AWS STS security token. If not set then the value of the AWS_SECURITY_TOKEN or EC2_SECURITY_TOKEN environment variable is used.
-
If profile is set this parameter is ignored.
-
Passing the security_token and profile options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01.
-

aliases: aws_security_token, access_token
-
-
- validate_certs - -
- boolean -
-
-
    Choices: -
  • no
  • -
  • yes ←
  • -
-
-
When set to "no", SSL certificates will not be validated for communication with the AWS APIs.
-
-
- - -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. - - Modules based on the original AWS SDK (boto) may read their default configuration from different files. See https://boto.readthedocs.io/en/latest/boto_config_tut.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 - - --- - # Simple example of listing all info for a function - - name: List all for a specific function - community.aws.lambda_facts: - query: all - function_name: myFunction - register: my_function_details - - # List all versions of a function - - name: List function versions - community.aws.lambda_facts: - query: versions - function_name: myFunction - register: my_function_versions - - # List all lambda function versions - - name: List all function - community.aws.lambda_facts: - query: all - max_items: 20 - - name: show Lambda facts - ansible.builtin.debug: - var: lambda_facts - - - -Return Values -------------- -Common return values are documented `here `_, the following are the fields unique to this module: - -.. raw:: html - - - - - - - - - - - - - - - - - - - - - - -
KeyReturnedDescription
-
- lambda_facts - -
- dictionary -
-
success -
lambda facts
-
-
-
- lambda_facts.function - -
- dictionary -
-
success -
lambda function list
-
-
-
- lambda_facts.function.TheName - -
- dictionary -
-
success -
lambda function information, including event, mapping, and version information
-
-
-

- - -Status ------- - - -- This module will be removed in a release after 2021-12-01. *[deprecated]* -- For more information see `DEPRECATED`_. - - -Authors -~~~~~~~ - -- Pierre Jodouin (@pjodouin) diff --git a/docs/community.aws.lambda_info_module.rst b/docs/community.aws.lambda_info_module.rst index d702b6a8405..07fa4405694 100644 --- a/docs/community.aws.lambda_info_module.rst +++ b/docs/community.aws.lambda_info_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.lambda_module.rst b/docs/community.aws.lambda_module.rst index 682891507e9..9de93b4b039 100644 --- a/docs/community.aws.lambda_module.rst +++ b/docs/community.aws.lambda_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.lambda_policy_module.rst b/docs/community.aws.lambda_policy_module.rst index ca1dd8a9309..dc04edcb31c 100644 --- a/docs/community.aws.lambda_policy_module.rst +++ b/docs/community.aws.lambda_policy_module.rst @@ -28,8 +28,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.lightsail_module.rst b/docs/community.aws.lightsail_module.rst index 441529b5378..82b16871951 100644 --- a/docs/community.aws.lightsail_module.rst +++ b/docs/community.aws.lightsail_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.rds_instance_info_module.rst b/docs/community.aws.rds_instance_info_module.rst index e1777ebb65a..679053cf3bf 100644 --- a/docs/community.aws.rds_instance_info_module.rst +++ b/docs/community.aws.rds_instance_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Obtain information about one or more RDS instances. -- This module was called ``rds_instance_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.rds_instance_module.rst b/docs/community.aws.rds_instance_module.rst index 2bb3a389893..c5ca750de7c 100644 --- a/docs/community.aws.rds_instance_module.rst +++ b/docs/community.aws.rds_instance_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.rds_instance_snapshot_module.rst b/docs/community.aws.rds_instance_snapshot_module.rst index 8601f7b83d5..846992c72d1 100644 --- a/docs/community.aws.rds_instance_snapshot_module.rst +++ b/docs/community.aws.rds_instance_snapshot_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.rds_module.rst b/docs/community.aws.rds_module.rst deleted file mode 100644 index a9ee106a16a..00000000000 --- a/docs/community.aws.rds_module.rst +++ /dev/null @@ -1,1718 +0,0 @@ -.. _community.aws.rds_module: - - -***************** -community.aws.rds -***************** - -**create, delete, or modify Amazon rds instances, rds snapshots, and related facts** - - -Version added: 1.0.0 - -.. contents:: - :local: - :depth: 1 - -DEPRECATED ----------- -:Removed in collection release after -:Why: The rds module is based upon a deprecated version of the AWS SDK. -:Alternative: Use :ref:`community.aws.rds_instance `, :ref:`community.aws.rds_instance_info `, and :ref:`community.aws.rds_instance_snapshot `. - - - -Synopsis --------- -- Creates, deletes, or modifies rds resources. -- When creating an instance it can be either a new instance or a read-only replica of an existing instance. -- The 'promote' command requires boto >= 2.18.0. Certain features such as tags rely on boto.rds2 (boto >= 2.26.0). -- Please use the boto3 based :ref:`community.aws.rds_instance ` instead. - - - -Requirements ------------- -The below requirements are needed on the host that executes this module. - -- boto >= 2.49.0 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 -- python >= 3.6 - - -Parameters ----------- - -.. raw:: html - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ParameterChoices/DefaultsComments
-
- apply_immediately - -
- boolean -
-
-
    Choices: -
  • no ←
  • -
  • yes
  • -
-
-
When apply_immediately=true, the modifications will be applied as soon as possible rather than waiting for the next preferred maintenance window.
-
Used only when command=modify.
-
-
- aws_access_key - -
- string -
-
- -
AWS access key. If not set then the value of the AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY or EC2_ACCESS_KEY environment variable is used.
-
If profile is set this parameter is ignored.
-
Passing the aws_access_key and profile options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01.
-

aliases: ec2_access_key, access_key
-
-
- aws_ca_bundle - -
- path -
-
- -
The location of a CA Bundle to use when validating SSL certificates.
-
Not used by boto 2 based modules.
-
Note: The CA Bundle is read 'module' side and may need to be explicitly copied from the controller if not run locally.
-
-
- aws_config - -
- dictionary -
-
- -
A dictionary to modify the botocore configuration.
- -
Only the 'user_agent' key is used for boto modules. See http://boto.cloudhackers.com/en/latest/boto_config_tut.html#boto for more boto configuration.
-
-
- aws_secret_key - -
- string -
-
- -
AWS secret key. If not set then the value of the AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY, or EC2_SECRET_KEY environment variable is used.
-
If profile is set this parameter is ignored.
-
Passing the aws_secret_key and profile options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01.
-

aliases: ec2_secret_key, secret_key
-
-
- backup_retention - -
- string -
-
- -
Number of days backups are retained.
-
Set to 0 to disable backups.
-
Default is 1 day.
-
Valid range: 0-35.
-
Used only when command=create or command=modify.
-
-
- backup_window - -
- string -
-
- -
Backup window in format of hh24:mi-hh24:mi. (Example: 18:00-20:30)
-
Times are specified in UTC.
-
If not specified then a random backup window is assigned.
-
Used only when command=create or command=modify.
-
-
- character_set_name - -
- string -
-
- -
Associate the DB instance with a specified character set.
-
Used with command=create.
-
-
- command - -
- string - / required -
-
-
    Choices: -
  • create
  • -
  • replicate
  • -
  • delete
  • -
  • facts
  • -
  • modify
  • -
  • promote
  • -
  • snapshot
  • -
  • reboot
  • -
  • restore
  • -
-
-
Specifies the action to take. The 'reboot' option is available starting at version 2.0.
-
-
- db_engine - -
- string -
-
-
    Choices: -
  • mariadb
  • -
  • MySQL
  • -
  • oracle-se1
  • -
  • oracle-se2
  • -
  • oracle-se
  • -
  • oracle-ee
  • -
  • sqlserver-ee
  • -
  • sqlserver-se
  • -
  • sqlserver-ex
  • -
  • sqlserver-web
  • -
  • postgres
  • -
  • aurora
  • -
-
-
The type of database.
-
Used only when command=create.
-
mariadb was added in version 2.2.
-
-
- db_name - -
- string -
-
- -
Name of a database to create within the instance.
-
If not specified then no database is created.
-
Used only when command=create.
-
-
- debug_botocore_endpoint_logs - -
- boolean -
-
-
    Choices: -
  • no ←
  • -
  • yes
  • -
-
-
Use a botocore.endpoint logger to parse the unique (rather than total) "resource:action" 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.
-
-
- ec2_url - -
- string -
-
- -
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.
-

aliases: aws_endpoint_url, endpoint_url
-
-
- engine_version - -
- string -
-
- -
Version number of the database engine to use.
-
If not specified then the current Amazon RDS default engine version is used
-
Used only when command=create.
-
-
- force_failover - -
- boolean -
-
-
    Choices: -
  • no ←
  • -
  • yes
  • -
-
-
If enabled, the reboot is done using a MultiAZ failover.
-
Used only when command=reboot.
-
-
- instance_name - -
- string -
-
- -
Database instance identifier.
-
Required except when using command=facts or command=delete on just a snapshot.
-
-
- instance_type - -
- string -
-
- -
The instance type of the database.
-
If not specified then the replica inherits the same instance type as the source instance.
-
Required when command=create.
-
Optional when command=replicate, command=modify or command=restore.
-

aliases: type
-
-
- iops - -
- string -
-
- -
Specifies the number of IOPS for the instance.
-
Used only when command=create or command=modify.
-
Must be an integer greater than 1000.
-
-
- license_model - -
- string -
-
-
    Choices: -
  • license-included
  • -
  • bring-your-own-license
  • -
  • general-public-license
  • -
  • postgresql-license
  • -
-
-
The license model for this DB instance.
-
Used only when command=create or command=restore.
-
-
- maint_window - -
- string -
-
- -
Maintenance window in format of ddd:hh24:mi-ddd:hh24:mi. (Example: Mon:22:00-Mon:23:15)
-
Times are specified in UTC.
-
If not specified then a random maintenance window is assigned.
-
Used only when command=create or command=modify.
-
-
- multi_zone - -
- boolean -
-
-
    Choices: -
  • no
  • -
  • yes
  • -
-
-
Specifies if this is a Multi-availability-zone deployment.
-
Can not be used in conjunction with zone parameter.
-
Used only when command=create or command=modify.
-
-
- new_instance_name - -
- string -
-
- -
Name to rename an instance to.
-
Used only when command=modify.
-
-
- option_group - -
- string -
-
- -
The name of the option group to use.
-
If not specified then the default option group is used.
-
Used only when command=create.
-
-
- parameter_group - -
- string -
-
- -
Name of the DB parameter group to associate with this instance.
-
If omitted then the RDS default DBParameterGroup will be used.
-
Used only when command=create or command=modify.
-
-
- password - -
- string -
-
- -
Password for the master database username.
-
Used only when command=create or command=modify.
-
-
- port - -
- integer -
-
- -
Port number that the DB instance uses for connections.
-
Used only when command=create or command=replicate.
-
Defaults to the standard ports for each db_engine: 3306 for MySQL and MariaDB, 1521 for Oracle 1433 for SQL Server, 5432 for PostgreSQL.
-
-
- profile - -
- string -
-
- -
Using profile will override aws_access_key, aws_secret_key and security_token and support for passing them at the same time as profile has been deprecated.
-
aws_access_key, aws_secret_key and security_token will be made mutually exclusive with profile after 2022-06-01.
-

aliases: aws_profile
-
-
- publicly_accessible - -
- string -
-
- -
Explicitly set whether the resource should be publicly accessible or not.
-
Used with command=create, command=replicate.
-
Requires boto >= 2.26.0
-
-
- region - -
- string -
-
- -
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 http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
-

aliases: aws_region, ec2_region
-
-
- security_groups - -
- string -
-
- -
Comma separated list of one or more security groups.
-
Used only when command=create or command=modify.
-
-
- security_token - -
- string -
-
- -
AWS STS security token. If not set then the value of the AWS_SECURITY_TOKEN or EC2_SECURITY_TOKEN environment variable is used.
-
If profile is set this parameter is ignored.
-
Passing the security_token and profile options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01.
-

aliases: aws_security_token, access_token
-
-
- size - -
- string -
-
- -
Size in gigabytes of the initial storage for the DB instance.
-
Used only when command=create or command=modify.
-
-
- snapshot - -
- string -
-
- -
Name of snapshot to take.
-
When command=delete, if no snapshot name is provided then no snapshot is taken.
-
When command=delete, if no instance_name is provided the snapshot is deleted.
-
Used with command=facts, command=delete or command=snapshot.
-
-
- source_instance - -
- string -
-
- -
Name of the database to replicate.
-
Used only when command=replicate.
-
-
- subnet - -
- string -
-
- -
VPC subnet group.
-
If specified then a VPC instance is created.
-
Used only when command=create.
-
-
- tags - -
- dictionary -
-
- -
tags dict to apply to a resource.
-
Used with command=create, command=replicate, command=restore.
-
Requires boto >= 2.26.0
-
-
- upgrade - -
- boolean -
-
-
    Choices: -
  • no ←
  • -
  • yes
  • -
-
-
Indicates that minor version upgrades should be applied automatically.
-
Used only when command=create or command=modify or command=restore or command=replicate.
-
-
- username - -
- string -
-
- -
Master database username.
-
Used only when command=create.
-
-
- validate_certs - -
- boolean -
-
-
    Choices: -
  • no
  • -
  • yes ←
  • -
-
-
When set to "no", SSL certificates will not be validated for communication with the AWS APIs.
-
-
- vpc_security_groups - -
- list - / elements=string -
-
- -
Comma separated list of one or more vpc security group ids.
-
Also requires subnet to be specified.
-
Used only when command=create or command=modify.
-
-
- wait - -
- boolean -
-
-
    Choices: -
  • no ←
  • -
  • yes
  • -
-
-
When command=create, replicate, modify or restore then wait for the database to enter the 'available' state.
-
When command=delete, wait for the database to be terminated.
-
-
- wait_timeout - -
- integer -
-
- Default:
300
-
-
How long before wait gives up, in seconds.
-
Used when wait=true.
-
-
- zone - -
- string -
-
- -
availability zone in which to launch the instance.
-
Used only when command=create, command=replicate or command=restore.
-
Can not be used in conjunction with multi_zone parameter.
-

aliases: aws_zone, ec2_zone
-
-
- - -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. - - Modules based on the original AWS SDK (boto) may read their default configuration from different files. See https://boto.readthedocs.io/en/latest/boto_config_tut.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 - - - name: Basic mysql provisioning example - community.aws.rds: - command: create - instance_name: new-database - db_engine: MySQL - size: 10 - instance_type: db.m1.small - username: mysql_admin - password: 1nsecure - tags: - Environment: testing - Application: cms - - - name: Create a read-only replica and wait for it to become available - community.aws.rds: - command: replicate - instance_name: new-database-replica - source_instance: new_database - wait: yes - wait_timeout: 600 - - - name: Delete an instance, but create a snapshot before doing so - community.aws.rds: - command: delete - instance_name: new-database - snapshot: new_database_snapshot - - - name: Get facts about an instance - community.aws.rds: - command: facts - instance_name: new-database - register: new_database_facts - - - name: Rename an instance and wait for the change to take effect - community.aws.rds: - command: modify - instance_name: new-database - new_instance_name: renamed-database - wait: yes - - - name: Reboot an instance and wait for it to become available again - community.aws.rds: - command: reboot - instance_name: database - wait: yes - - # Restore a Postgres db instance from a snapshot, wait for it to become available again, and - # then modify it to add your security group. Also, display the new endpoint. - # Note that the "publicly_accessible" option is allowed here just as it is in the AWS CLI - - community.aws.rds: - command: restore - snapshot: mypostgres-snapshot - instance_name: MyNewInstanceName - region: us-west-2 - zone: us-west-2b - subnet: default-vpc-xx441xxx - publicly_accessible: yes - wait: yes - wait_timeout: 600 - tags: - Name: pg1_test_name_tag - register: rds - - - community.aws.rds: - command: modify - instance_name: MyNewInstanceName - region: us-west-2 - vpc_security_groups: sg-xxx945xx - - - ansible.builtin.debug: - msg: "The new db endpoint is {{ rds.instance.endpoint }}" - - - -Return Values -------------- -Common return values are documented `here `_, the following are the fields unique to this module: - -.. raw:: html - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
KeyReturnedDescription
-
- instance - -
- complex -
-
always -
the rds instance
-
-
  -
- allocated_storage - -
- string -
-
when RDS instance exists -
the allocated storage size in gigabytes (GB)
-
-
Sample:
-
100
-
  -
- auto_minor_version_upgrade - -
- boolean -
-
when RDS instance exists -
indicates that minor engine upgrades will be applied automatically to the DB instance during the maintenance window
-
-
Sample:
-
true
-
  -
- backup_window - -
- string -
-
when RDS instance exists and automated backups are enabled -
the daily time range during which automated backups are created if automated backups are enabled
-
-
Sample:
-
03:00-03:30
-
  -
- character_set_name - -
- string -
-
when RDS instance exists -
the name of the character set that this instance is associated with
-
-
Sample:
-
AL32UTF8
-
  -
- db_name - -
- string -
-
when RDS instance exists -
the name of the database to create when the DB instance is created
-
-
Sample:
-
ASERTG
-
  -
- db_subnet_groups - -
- complex -
-
when RDS instance exists -
information on the subnet group associated with this RDS instance
-
-
   -
- description - -
- string -
-
when RDS instance exists -
the subnet group associated with the DB instance
-
-
Sample:
-
Subnets for the UAT RDS SQL DB Instance
-
   -
- name - -
- string -
-
when RDS instance exists -
the name of the DB subnet group
-
-
Sample:
-
samplesubnetgrouprds-j6paiqkxqp4z
-
   -
- status - -
- string -
-
when RDS instance exists -
the status of the DB subnet group
-
-
Sample:
-
complete
-
   -
- subnets - -
- complex -
-
when RDS instance exists -
the description of the DB subnet group
-
-
    -
- availability_zone - -
- complex -
-
when RDS instance exists -
subnet availability zone information
-
-
     -
- name - -
- string -
-
when RDS instance exists -
availability zone
-
-
Sample:
-
eu-west-1b
-
     -
- provisioned_iops_capable - -
- boolean -
-
when RDS instance exists -
whether provisioned iops are available in AZ subnet
-
-
Sample:
-
false
-
    -
- identifier - -
- string -
-
when RDS instance exists -
the identifier of the subnet
-
-
Sample:
-
subnet-3fdba63e
-
    -
- status - -
- string -
-
when RDS instance exists -
the status of the subnet
-
-
Sample:
-
active
-
  -
- endpoint - -
- string -
-
when RDS instance exists -
the endpoint uri of the database instance
-
-
Sample:
-
my-ansible-database.asdfaosdgih.us-east-1.rds.amazonaws.com
-
  -
- engine - -
- string -
-
when RDS instance exists -
the name of the database engine
-
-
Sample:
-
oracle-se
-
  -
- engine_version - -
- string -
-
when RDS instance exists -
the version of the database engine
-
-
Sample:
-
11.2.0.4.v6
-
  -
- latest_restorable_time - -
- string -
-
when RDS instance exists -
the latest time to which a database can be restored with point-in-time restore
-
-
Sample:
-
1489707802.0
-
  -
- license_model - -
- string -
-
when RDS instance exists -
the license model information
-
-
Sample:
-
bring-your-own-license
-
  -
- option_groups - -
- complex -
-
when RDS instance exists -
the list of option group memberships for this RDS instance
-
-
   -
- option_group_name - -
- string -
-
when RDS instance exists -
the option group name for this RDS instance
-
-
Sample:
-
default:oracle-se-11-2
-
   -
- status - -
- string -
-
when RDS instance exists -
the status of the RDS instance's option group membership
-
-
Sample:
-
in-sync
-
  -
- parameter_groups - -
- complex -
-
when RDS instance exists and parameter groups are defined -
the list of DB parameter groups applied to this RDS instance
-
-
   -
- parameter_apply_status - -
- string -
-
when RDS instance exists -
the status of parameter updates
-
-
Sample:
-
in-sync
-
   -
- parameter_group_name - -
- string -
-
when RDS instance exists -
the name of the DP parameter group
-
-
Sample:
-
testawsrpprodb01spfile-1ujg7nrs7sgyz
-
  -
- pending_modified_values - -
- complex -
-
when RDS instance exists -
a dictionary of changes to the RDS instance that are pending
-
-
   -
- allocated_storage - -
- string -
-
when RDS instance exists -
the new allocated storage size for this RDS instance that will be applied or is in progress
-
-
Sample:
-
null
-
   -
- backup_retention_period - -
- string -
-
when RDS instance exists -
the pending number of days for which automated backups are retained
-
-
Sample:
-
null
-
   -
- db_instance_class - -
- string -
-
when RDS instance exists -
the new DB instance class for this RDS instance that will be applied or is in progress
-
-
Sample:
-
null
-
   -
- db_instance_identifier - -
- string -
-
when RDS instance exists -
the new DB instance identifier this RDS instance that will be applied or is in progress
-
-
Sample:
-
null
-
   -
- engine_version - -
- string -
-
when RDS instance exists -
indicates the database engine version
-
-
Sample:
-
null
-
   -
- iops - -
- string -
-
when RDS instance exists -
the new provisioned IOPS value for this RDS instance that will be applied or is being applied
-
-
Sample:
-
null
-
   -
- master_user_password - -
- string -
-
when RDS instance exists -
the pending or in-progress change of the master credentials for this RDS instance
-
-
Sample:
-
null
-
   -
- multi_az - -
- string -
-
when RDS instance exists -
indicates that the single-AZ RDS instance is to change to a multi-AZ deployment
-
-
Sample:
-
null
-
   -
- port - -
- string -
-
when RDS instance exists -
specifies the pending port for this RDS instance
-
-
Sample:
-
null
-
  -
- port - -
- integer -
-
when RDS instance exists -
the listening port of the database instance
-
-
Sample:
-
3306
-
  -
- publicly_accessible - -
- boolean -
-
when RDS instance exists -
the accessibility options for the DB instance
-
-
Sample:
-
true
-
  -
- read_replica_source_dbinstance_identifier - -
- string -
-
when read replica RDS instance exists -
the identifier of the source DB instance if this RDS instance is a read replica
-
-
Sample:
-
null
-
  -
- secondary_availability_zone - -
- string -
-
when RDS instance exists and is multi-AZ -
the name of the secondary AZ for a DB instance with multi-AZ support
-
-
Sample:
-
eu-west-1b
-
-

- - -Status ------- - - -- This module will be removed in version 3.0.0. *[deprecated]* -- For more information see `DEPRECATED`_. - - -Authors -~~~~~~~ - -- Bruce Pennypacker (@bpennypacker) -- Will Thames (@willthames) diff --git a/docs/community.aws.rds_option_group_info_module.rst b/docs/community.aws.rds_option_group_info_module.rst index 6c8aaa81e4c..b53709f69c8 100644 --- a/docs/community.aws.rds_option_group_info_module.rst +++ b/docs/community.aws.rds_option_group_info_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.rds_option_group_module.rst b/docs/community.aws.rds_option_group_module.rst index e712b76ef8f..8b4684bd3a2 100644 --- a/docs/community.aws.rds_option_group_module.rst +++ b/docs/community.aws.rds_option_group_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.rds_param_group_module.rst b/docs/community.aws.rds_param_group_module.rst index 9715206d56c..995c6ac3cfc 100644 --- a/docs/community.aws.rds_param_group_module.rst +++ b/docs/community.aws.rds_param_group_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.rds_snapshot_info_module.rst b/docs/community.aws.rds_snapshot_info_module.rst index 7e5c169f9fe..afe7160c727 100644 --- a/docs/community.aws.rds_snapshot_info_module.rst +++ b/docs/community.aws.rds_snapshot_info_module.rst @@ -19,7 +19,6 @@ Synopsis -------- - Obtain information about one or more RDS snapshots. These can be for unclustered snapshots or snapshots of clustered DBs (Aurora). - Aurora snapshot information may be obtained if no identifier parameters are passed or if one of the cluster parameters are passed. -- This module was called ``rds_snapshot_facts`` before Ansible 2.9. The usage did not change. @@ -28,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.rds_subnet_group_module.rst b/docs/community.aws.rds_subnet_group_module.rst index f981bca5846..0a14fd0869f 100644 --- a/docs/community.aws.rds_subnet_group_module.rst +++ b/docs/community.aws.rds_subnet_group_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.redshift_cross_region_snapshots_module.rst b/docs/community.aws.redshift_cross_region_snapshots_module.rst index 10e633cb2e0..d6b0e3599b6 100644 --- a/docs/community.aws.redshift_cross_region_snapshots_module.rst +++ b/docs/community.aws.redshift_cross_region_snapshots_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.redshift_info_module.rst b/docs/community.aws.redshift_info_module.rst index 6535817f66c..458b4fd1aac 100644 --- a/docs/community.aws.redshift_info_module.rst +++ b/docs/community.aws.redshift_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gather information about Redshift cluster(s). -- This module was called ``redshift_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.redshift_module.rst b/docs/community.aws.redshift_module.rst index c5bd313bacc..bb86f34d73f 100644 --- a/docs/community.aws.redshift_module.rst +++ b/docs/community.aws.redshift_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.redshift_subnet_group_module.rst b/docs/community.aws.redshift_subnet_group_module.rst index 9cd895d9409..2c462b909aa 100644 --- a/docs/community.aws.redshift_subnet_group_module.rst +++ b/docs/community.aws.redshift_subnet_group_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.route53_health_check_module.rst b/docs/community.aws.route53_health_check_module.rst index 4b6c8fc96ea..ca14e3a9610 100644 --- a/docs/community.aws.route53_health_check_module.rst +++ b/docs/community.aws.route53_health_check_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.route53_info_module.rst b/docs/community.aws.route53_info_module.rst index d81b24597e5..31f53b92b7a 100644 --- a/docs/community.aws.route53_info_module.rst +++ b/docs/community.aws.route53_info_module.rst @@ -18,7 +18,6 @@ Version added: 1.0.0 Synopsis -------- - Gets various details related to Route53 zone, record set or health check details. -- This module was called ``route53_facts`` before Ansible 2.9. The usage did not change. @@ -27,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters @@ -278,7 +277,7 @@ Parameters max_items
- string + integer
@@ -432,6 +431,9 @@ Parameters
  • SPF
  • CAA
  • NS
  • +
  • NAPTR
  • +
  • SOA
  • +
  • DS
  • diff --git a/docs/community.aws.route53_module.rst b/docs/community.aws.route53_module.rst index 80f7049d985..aa99a6cd090 100644 --- a/docs/community.aws.route53_module.rst +++ b/docs/community.aws.route53_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters @@ -492,7 +492,6 @@ Parameters
    The new value when creating a DNS record. YAML lists or multiple comma-spaced values are allowed for non-alias records.
    -
    When deleting a record all values for the record must be specified or Route 53 will not delete it.
    diff --git a/docs/community.aws.route53_zone_module.rst b/docs/community.aws.route53_zone_module.rst index a43dcbb9b73..ca8a9e81abe 100644 --- a/docs/community.aws.route53_zone_module.rst +++ b/docs/community.aws.route53_zone_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.s3_bucket_notification_module.rst b/docs/community.aws.s3_bucket_notification_module.rst index 0f62c6e343b..a961673bfa7 100644 --- a/docs/community.aws.s3_bucket_notification_module.rst +++ b/docs/community.aws.s3_bucket_notification_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.s3_lifecycle_module.rst b/docs/community.aws.s3_lifecycle_module.rst index 6a940862780..b68e8bdf94f 100644 --- a/docs/community.aws.s3_lifecycle_module.rst +++ b/docs/community.aws.s3_lifecycle_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.s3_logging_module.rst b/docs/community.aws.s3_logging_module.rst index 67762810882..cb5df057e49 100644 --- a/docs/community.aws.s3_logging_module.rst +++ b/docs/community.aws.s3_logging_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.s3_metrics_configuration_module.rst b/docs/community.aws.s3_metrics_configuration_module.rst index 449fd5d9b1f..45a02c9c659 100644 --- a/docs/community.aws.s3_metrics_configuration_module.rst +++ b/docs/community.aws.s3_metrics_configuration_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.s3_sync_module.rst b/docs/community.aws.s3_sync_module.rst index 348639b2c2e..9027e8c1a93 100644 --- a/docs/community.aws.s3_sync_module.rst +++ b/docs/community.aws.s3_sync_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.s3_website_module.rst b/docs/community.aws.s3_website_module.rst index 90078b3afc3..f595a808d6b 100644 --- a/docs/community.aws.s3_website_module.rst +++ b/docs/community.aws.s3_website_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.sns_module.rst b/docs/community.aws.sns_module.rst index 177cf3c3452..ea41bb67d83 100644 --- a/docs/community.aws.sns_module.rst +++ b/docs/community.aws.sns_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.sns_topic_module.rst b/docs/community.aws.sns_topic_module.rst index d550bef0cb3..d1d0a146b03 100644 --- a/docs/community.aws.sns_topic_module.rst +++ b/docs/community.aws.sns_topic_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.sqs_queue_module.rst b/docs/community.aws.sqs_queue_module.rst index 347cf1f35fd..1bba3283850 100644 --- a/docs/community.aws.sqs_queue_module.rst +++ b/docs/community.aws.sqs_queue_module.rst @@ -27,8 +27,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters @@ -212,6 +212,7 @@ Parameters
    The ID of an AWS-managed customer master key (CMK) for Amazon SQS or a custom CMK.
    +
    Specifying a valid kms_master_key_id will enable encryption automatically.
    diff --git a/docs/community.aws.sts_assume_role_module.rst b/docs/community.aws.sts_assume_role_module.rst index bfab5056a22..ce482222bae 100644 --- a/docs/community.aws.sts_assume_role_module.rst +++ b/docs/community.aws.sts_assume_role_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.sts_session_token_module.rst b/docs/community.aws.sts_session_token_module.rst index 0a9b8e9c3a5..b0702b27f88 100644 --- a/docs/community.aws.sts_session_token_module.rst +++ b/docs/community.aws.sts_session_token_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.wafv2_ip_set_info_module.rst b/docs/community.aws.wafv2_ip_set_info_module.rst index 4f654bf6060..e988b6a2588 100644 --- a/docs/community.aws.wafv2_ip_set_info_module.rst +++ b/docs/community.aws.wafv2_ip_set_info_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.wafv2_ip_set_module.rst b/docs/community.aws.wafv2_ip_set_module.rst index 506e1b2e1e2..967651d60f0 100644 --- a/docs/community.aws.wafv2_ip_set_module.rst +++ b/docs/community.aws.wafv2_ip_set_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.wafv2_resources_info_module.rst b/docs/community.aws.wafv2_resources_info_module.rst index 934e20ed66a..94535f2545c 100644 --- a/docs/community.aws.wafv2_resources_info_module.rst +++ b/docs/community.aws.wafv2_resources_info_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.wafv2_resources_module.rst b/docs/community.aws.wafv2_resources_module.rst index ab010c46476..8b6bab30e17 100644 --- a/docs/community.aws.wafv2_resources_module.rst +++ b/docs/community.aws.wafv2_resources_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.wafv2_rule_group_info_module.rst b/docs/community.aws.wafv2_rule_group_info_module.rst index 9af6fceb5db..93a9c94101f 100644 --- a/docs/community.aws.wafv2_rule_group_info_module.rst +++ b/docs/community.aws.wafv2_rule_group_info_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.wafv2_rule_group_module.rst b/docs/community.aws.wafv2_rule_group_module.rst index 36094e45332..2cdb7c83316 100644 --- a/docs/community.aws.wafv2_rule_group_module.rst +++ b/docs/community.aws.wafv2_rule_group_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.wafv2_web_acl_info_module.rst b/docs/community.aws.wafv2_web_acl_info_module.rst index 761b4b9fd2c..7f8f4df2d17 100644 --- a/docs/community.aws.wafv2_web_acl_info_module.rst +++ b/docs/community.aws.wafv2_web_acl_info_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters diff --git a/docs/community.aws.wafv2_web_acl_module.rst b/docs/community.aws.wafv2_web_acl_module.rst index 32324dcd9b2..82d5f4028da 100644 --- a/docs/community.aws.wafv2_web_acl_module.rst +++ b/docs/community.aws.wafv2_web_acl_module.rst @@ -26,8 +26,8 @@ Requirements The below requirements are needed on the host that executes this module. - python >= 3.6 -- boto3 >= 1.15.0 -- botocore >= 1.18.0 +- boto3 >= 1.16.0 +- botocore >= 1.19.0 Parameters @@ -297,6 +297,7 @@ Parameters
    The Rule statements used to identify the web requests that you want to allow, block, or count.
    + @@ -523,7 +524,7 @@ Examples metric_name: blub rules: - name: zwei - priority: 2 + priority: 0 action: block: {} visibility_config: @@ -549,6 +550,59 @@ Examples managed_rule_group_statement: vendor_name: AWS name: AWSManagedRulesAdminProtectionRuleSet + + # AWS Managed Bad Input Rule Set + # but allow PROPFIND_METHOD used e.g. by webdav + - name: bad_input_protect_whitelist_webdav + priority: 2 + override_action: + none: {} + visibility_config: + sampled_requests_enabled: yes + cloud_watch_metrics_enabled: yes + metric_name: bad_input_protect + statement: + managed_rule_group_statement: + vendor_name: AWS + name: AWSManagedRulesKnownBadInputsRuleSet + excluded_rules: + - name: PROPFIND_METHOD + + # Rate Limit example. 1500 req/5min + # counted for two domains via or_statement. login.mydomain.tld and api.mydomain.tld + - name: rate_limit_example + priority: 3 + action: + block: {} + visibility_config: + sampled_requests_enabled: yes + cloud_watch_metrics_enabled: yes + metric_name: mydomain-ratelimit + statement: + rate_based_statement: + limit: 1500 + aggregate_key_type: IP + scope_down_statement: + or_statement: + statements: + - byte_match_statement: + search_string: login.mydomain.tld + positional_constraint: CONTAINS + field_to_match: + single_header: + name: host + text_transformations: + - type: LOWERCASE + priority: 0 + - byte_match_dtatement: + search_string: api.mydomain.tld + positional_constraint: CONTAINS + field_to_match: + single_header: + name: host + text_transformations: + - type: LOWERCASE + priority: 0 tags: A: B C: D diff --git a/galaxy.yml b/galaxy.yml index 95cee206cab..ad199aee279 100644 --- a/galaxy.yml +++ b/galaxy.yml @@ -1,6 +1,6 @@ namespace: community name: aws -version: 2.1.0 +version: 3.0.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: '>=2.1.0' + amazon.aws: '>=3.0.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/meta/runtime.yml b/meta/runtime.yml index 2e7578e50b5..ab5bb4e0bb8 100644 --- a/meta/runtime.yml +++ b/meta/runtime.yml @@ -187,23 +187,10 @@ plugin_routing: modules: ec2_elb: redirect: community.aws.elb_instance - deprecation: - removal_version: 3.0.0 - warning_text: >- - ec2_elb was renamed in community.aws 2.0.0 to - elb_instance. - Please update your tasks. ec2_instance: redirect: amazon.aws.ec2_instance ec2_instance_info: redirect: amazon.aws.ec2_instance_info - ec2_elb_info: - deprecation: - removal_version: 3.0.0 - warning_text: >- - The ec2_elb_info module has been deprecated and replaced by - the elb_classic_lb_info module. - Please update your tasks. ec2_vpc_endpoint: redirect: amazon.aws.ec2_vpc_endpoint ec2_vpc_endpoint_info: @@ -220,13 +207,6 @@ plugin_routing: redirect: amazon.aws.ec2_vpc_nat_gateway_info elb_classic_lb: redirect: amazon.aws.ec2_elb_lb - iam: - deprecation: - removal_version: 3.0.0 - warning_text: >- - The iam module is based upon a deprecated version of the AWS SDKs - and is deprecated in favor of the iam_user, iam_group and iam_role modules. - Please update your tasks. iam_cert: redirect: community.aws.iam_server_certificate deprecation: @@ -234,13 +214,6 @@ plugin_routing: warning_text: >- iam_cert has been renamed to iam_server_certificate for consistency. Please update your tasks. - rds: - deprecation: - removal_version: 3.0.0 - warning_text: >- - The rds module is based upon a deprecated version of the AWS SDKs - and is deprecated in favor of the rds_instance and rds_snapshot modules. - Please update your tasks. rds_snapshot: redirect: community.aws.rds_instance_snapshot deprecation: diff --git a/tests/requirements.yml b/tests/requirements.yml index 8038ae1d456..98b77a44496 100644 --- a/tests/requirements.yml +++ b/tests/requirements.yml @@ -1,7 +1,7 @@ integration_tests_dependencies: -- amazon.aws >= 2.1.0 +- amazon.aws >= 3.0.0 - ansible.windows - community.crypto - community.general unit_tests_dependencies: -- amazon.aws >= 2.1.0 +- amazon.aws >= 3.0.0