AWS SSM connection: Add ability to specify S3 addressing style
This is useful for newly created buckets in combination with private s3 endpoints.
SUMMARY
This is useful for newly created buckets in combination with private s3 endpoints where the current code just breaks
ISSUE TYPE
- Bugfix Pull Request
COMPONENT NAME
aws_ssm
I'm the author - for air-gap reasons, the PR had to be submitted by Tim.
This allows a workaround to a problem where S3 bucket access via S3 Private VPC endpoints didn't work, due to the lack of the region in the URL (despite supplying it)
See https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-bucket-intro.html for more information.
The PR just allows the bucket access method to be set. The default is "auto" which is the boto3 default.
@markuman possible to merge this PR with https://github.com/ansible-collections/community.aws/pull/854 ? @james-masson can you add a "minor" changlog fragment
please take care this PR. I think #705 should not close yet.
recheck
Build succeeded.
:x: ansible-galaxy-importer FAILURE in 4m 38s (non-voting) :heavy_check_mark: build-ansible-collection SUCCESS in 4m 38s :heavy_check_mark: ansible-test-sanity-docker-devel SUCCESS in 9m 10s (non-voting) :heavy_check_mark: ansible-test-sanity-docker-milestone SUCCESS in 10m 10s :heavy_check_mark: ansible-test-sanity-docker-stable-2.9 SUCCESS in 11m 55s :heavy_check_mark: ansible-test-sanity-docker-stable-2.11 SUCCESS in 11m 15s :heavy_check_mark: ansible-test-sanity-docker-stable-2.12 SUCCESS in 9m 20s :heavy_check_mark: ansible-test-units-community-aws-python38 SUCCESS in 6m 02s :heavy_check_mark: ansible-test-splitter SUCCESS in 3m 23s :warning: integration-community.aws-1 SKIPPED :warning: integration-community.aws-2 SKIPPED :warning: integration-community.aws-3 SKIPPED :warning: integration-community.aws-4 SKIPPED :warning: integration-community.aws-5 SKIPPED :warning: integration-community.aws-6 SKIPPED :warning: integration-community.aws-7 SKIPPED :warning: integration-community.aws-8 SKIPPED :warning: integration-community.aws-9 SKIPPED :warning: integration-community.aws-10 SKIPPED :warning: integration-community.aws-11 SKIPPED :warning: integration-community.aws-12 SKIPPED :warning: integration-community.aws-13 SKIPPED
Docs Build π
Thank you for contribution!β¨
The docsite for this PR is available for download as an artifact from this run: https://github.com/ansible-collections/community.aws/actions/runs/2297484868
File changes:
Acollections/community/aws/cloudfront_response_headers_policy_module.htmlAcollections/community/aws/ec2_asg_instance_refresh_module.htmlAcollections/community/aws/ec2_asg_scheduled_action_module.htmlAcollections/community/aws/ec2_transit_gateway_vpc_attachment_info_module.htmlAcollections/community/aws/ec2_transit_gateway_vpc_attachment_module.htmlAcollections/community/aws/networkfirewall_policy_info_module.htmlAcollections/community/aws/networkfirewall_policy_module.htmlAcollections/community/aws/networkfirewall_rule_group_info_module.htmlAcollections/community/aws/networkfirewall_rule_group_module.htmlAcollections/community/aws/rds_cluster_info_module.htmlAcollections/community/aws/rds_cluster_module.htmlAcollections/community/aws/sns_topic_info_module.htmlDcollections/community/aws/aws_acm_facts_module.htmlDcollections/community/aws/aws_kms_facts_module.htmlDcollections/community/aws/aws_region_facts_module.htmlDcollections/community/aws/aws_s3_bucket_facts_module.htmlDcollections/community/aws/aws_sgw_facts_module.htmlDcollections/community/aws/aws_waf_facts_module.htmlDcollections/community/aws/cloudfront_facts_module.htmlDcollections/community/aws/cloudwatchlogs_log_group_facts_module.htmlDcollections/community/aws/ec2_asg_facts_module.htmlDcollections/community/aws/ec2_customer_gateway_facts_module.htmlDcollections/community/aws/ec2_eip_facts_module.htmlDcollections/community/aws/ec2_elb_facts_module.htmlDcollections/community/aws/ec2_instance_facts_module.htmlDcollections/community/aws/ec2_lc_facts_module.htmlDcollections/community/aws/ec2_placement_group_facts_module.htmlDcollections/community/aws/ec2_vpc_endpoint_facts_module.htmlDcollections/community/aws/ec2_vpc_igw_facts_module.htmlDcollections/community/aws/ec2_vpc_nacl_facts_module.htmlDcollections/community/aws/ec2_vpc_nat_gateway_facts_module.htmlDcollections/community/aws/ec2_vpc_peering_facts_module.htmlDcollections/community/aws/ec2_vpc_route_table_facts_module.htmlDcollections/community/aws/ec2_vpc_vgw_facts_module.htmlDcollections/community/aws/ec2_vpc_vpn_facts_module.htmlDcollections/community/aws/ecs_service_facts_module.htmlDcollections/community/aws/ecs_taskdefinition_facts_module.htmlDcollections/community/aws/efs_facts_module.htmlDcollections/community/aws/elasticache_facts_module.htmlDcollections/community/aws/elb_application_lb_facts_module.htmlDcollections/community/aws/elb_classic_lb_facts_module.htmlDcollections/community/aws/elb_target_facts_module.htmlDcollections/community/aws/elb_target_group_facts_module.htmlDcollections/community/aws/iam_cert_facts_module.htmlDcollections/community/aws/iam_mfa_device_facts_module.htmlDcollections/community/aws/iam_role_facts_module.htmlDcollections/community/aws/iam_server_certificate_facts_module.htmlDcollections/community/aws/rds_instance_facts_module.htmlDcollections/community/aws/rds_module.htmlDcollections/community/aws/rds_snapshot_facts_module.htmlDcollections/community/aws/redshift_facts_module.htmlDcollections/community/aws/route53_facts_module.htmlMcollections/community/aws/aws_acm_info_module.htmlMcollections/community/aws/aws_acm_module.htmlMcollections/community/aws/aws_api_gateway_module.htmlMcollections/community/aws/aws_application_scaling_policy_module.htmlMcollections/community/aws/aws_batch_compute_environment_module.htmlMcollections/community/aws/aws_batch_job_definition_module.htmlMcollections/community/aws/aws_batch_job_queue_module.htmlMcollections/community/aws/aws_codebuild_module.htmlMcollections/community/aws/aws_codecommit_module.htmlMcollections/community/aws/aws_codepipeline_module.htmlMcollections/community/aws/aws_config_aggregation_authorization_module.htmlMcollections/community/aws/aws_config_aggregator_module.htmlMcollections/community/aws/aws_config_delivery_channel_module.htmlMcollections/community/aws/aws_config_recorder_module.htmlMcollections/community/aws/aws_config_rule_module.htmlMcollections/community/aws/aws_direct_connect_confirm_connection_module.htmlMcollections/community/aws/aws_direct_connect_connection_module.htmlMcollections/community/aws/aws_direct_connect_gateway_module.htmlMcollections/community/aws/aws_direct_connect_link_aggregation_group_module.htmlMcollections/community/aws/aws_direct_connect_virtual_interface_module.htmlMcollections/community/aws/aws_eks_cluster_module.htmlMcollections/community/aws/aws_elasticbeanstalk_app_module.htmlMcollections/community/aws/aws_glue_connection_module.htmlMcollections/community/aws/aws_glue_job_module.htmlMcollections/community/aws/aws_inspector_target_module.htmlMcollections/community/aws/aws_kms_info_module.htmlMcollections/community/aws/aws_kms_module.htmlMcollections/community/aws/aws_msk_cluster_module.htmlMcollections/community/aws/aws_msk_config_module.htmlMcollections/community/aws/aws_region_info_module.htmlMcollections/community/aws/aws_s3_bucket_info_module.htmlMcollections/community/aws/aws_s3_cors_module.htmlMcollections/community/aws/aws_secret_module.htmlMcollections/community/aws/aws_ses_identity_module.htmlMcollections/community/aws/aws_ses_identity_policy_module.htmlMcollections/community/aws/aws_ses_rule_set_module.htmlMcollections/community/aws/aws_sgw_info_module.htmlMcollections/community/aws/aws_ssm_connection.htmlMcollections/community/aws/aws_ssm_parameter_store_module.htmlMcollections/community/aws/aws_step_functions_state_machine_execution_module.htmlMcollections/community/aws/aws_step_functions_state_machine_module.htmlMcollections/community/aws/aws_waf_condition_module.htmlMcollections/community/aws/aws_waf_info_module.htmlMcollections/community/aws/aws_waf_rule_module.htmlMcollections/community/aws/aws_waf_web_acl_module.htmlMcollections/community/aws/cloudformation_exports_info_module.htmlMcollections/community/aws/cloudformation_stack_set_module.htmlMcollections/community/aws/cloudfront_distribution_module.htmlMcollections/community/aws/cloudfront_info_module.htmlMcollections/community/aws/cloudfront_invalidation_module.htmlMcollections/community/aws/cloudfront_origin_access_identity_module.htmlMcollections/community/aws/cloudtrail_module.htmlMcollections/community/aws/cloudwatchevent_rule_module.htmlMcollections/community/aws/cloudwatchlogs_log_group_info_module.htmlMcollections/community/aws/cloudwatchlogs_log_group_metric_filter_module.htmlMcollections/community/aws/cloudwatchlogs_log_group_module.htmlMcollections/community/aws/data_pipeline_module.htmlMcollections/community/aws/dms_endpoint_module.htmlMcollections/community/aws/dms_replication_subnet_group_module.htmlMcollections/community/aws/dynamodb_table_module.htmlMcollections/community/aws/dynamodb_ttl_module.htmlMcollections/community/aws/ec2_ami_copy_module.htmlMcollections/community/aws/ec2_asg_info_module.htmlMcollections/community/aws/ec2_asg_lifecycle_hook_module.htmlMcollections/community/aws/ec2_asg_module.htmlMcollections/community/aws/ec2_customer_gateway_info_module.htmlMcollections/community/aws/ec2_customer_gateway_module.htmlMcollections/community/aws/ec2_eip_info_module.htmlMcollections/community/aws/ec2_eip_module.htmlMcollections/community/aws/ec2_elb_module.htmlMcollections/community/aws/ec2_instance_info_module.htmlMcollections/community/aws/ec2_instance_module.htmlMcollections/community/aws/ec2_launch_template_module.htmlMcollections/community/aws/ec2_lc_find_module.htmlMcollections/community/aws/ec2_lc_info_module.htmlMcollections/community/aws/ec2_lc_module.htmlMcollections/community/aws/ec2_metric_alarm_module.htmlMcollections/community/aws/ec2_placement_group_info_module.htmlMcollections/community/aws/ec2_placement_group_module.htmlMcollections/community/aws/ec2_scaling_policy_module.htmlMcollections/community/aws/ec2_snapshot_copy_module.htmlMcollections/community/aws/ec2_transit_gateway_info_module.htmlMcollections/community/aws/ec2_transit_gateway_module.htmlMcollections/community/aws/ec2_vpc_egress_igw_module.htmlMcollections/community/aws/ec2_vpc_endpoint_info_module.htmlMcollections/community/aws/ec2_vpc_endpoint_module.htmlMcollections/community/aws/ec2_vpc_endpoint_service_info_module.htmlMcollections/community/aws/ec2_vpc_igw_info_module.htmlMcollections/community/aws/ec2_vpc_igw_module.htmlMcollections/community/aws/ec2_vpc_nacl_info_module.htmlMcollections/community/aws/ec2_vpc_nacl_module.htmlMcollections/community/aws/ec2_vpc_nat_gateway_info_module.htmlMcollections/community/aws/ec2_vpc_nat_gateway_module.htmlMcollections/community/aws/ec2_vpc_peer_module.htmlMcollections/community/aws/ec2_vpc_peering_info_module.htmlMcollections/community/aws/ec2_vpc_route_table_info_module.htmlMcollections/community/aws/ec2_vpc_route_table_module.htmlMcollections/community/aws/ec2_vpc_vgw_info_module.htmlMcollections/community/aws/ec2_vpc_vgw_module.htmlMcollections/community/aws/ec2_vpc_vpn_info_module.htmlMcollections/community/aws/ec2_vpc_vpn_module.htmlMcollections/community/aws/ec2_win_password_module.htmlMcollections/community/aws/ecs_attribute_module.htmlMcollections/community/aws/ecs_cluster_module.htmlMcollections/community/aws/ecs_ecr_module.htmlMcollections/community/aws/ecs_service_info_module.htmlMcollections/community/aws/ecs_service_module.htmlMcollections/community/aws/ecs_tag_module.htmlMcollections/community/aws/ecs_task_module.htmlMcollections/community/aws/ecs_taskdefinition_info_module.htmlMcollections/community/aws/ecs_taskdefinition_module.htmlMcollections/community/aws/efs_info_module.htmlMcollections/community/aws/efs_module.htmlMcollections/community/aws/efs_tag_module.htmlMcollections/community/aws/elasticache_info_module.htmlMcollections/community/aws/elasticache_module.htmlMcollections/community/aws/elasticache_parameter_group_module.htmlMcollections/community/aws/elasticache_snapshot_module.htmlMcollections/community/aws/elasticache_subnet_group_module.htmlMcollections/community/aws/elb_application_lb_info_module.htmlMcollections/community/aws/elb_application_lb_module.htmlMcollections/community/aws/elb_classic_lb_info_module.htmlMcollections/community/aws/elb_classic_lb_module.htmlMcollections/community/aws/elb_instance_module.htmlMcollections/community/aws/elb_network_lb_module.htmlMcollections/community/aws/elb_target_group_info_module.htmlMcollections/community/aws/elb_target_group_module.htmlMcollections/community/aws/elb_target_info_module.htmlMcollections/community/aws/elb_target_module.htmlMcollections/community/aws/execute_lambda_module.htmlMcollections/community/aws/iam_access_key_info_module.htmlMcollections/community/aws/iam_access_key_module.htmlMcollections/community/aws/iam_cert_module.htmlMcollections/community/aws/iam_group_module.htmlMcollections/community/aws/iam_managed_policy_module.htmlMcollections/community/aws/iam_mfa_device_info_module.htmlMcollections/community/aws/iam_password_policy_module.htmlMcollections/community/aws/iam_policy_info_module.htmlMcollections/community/aws/iam_policy_module.htmlMcollections/community/aws/iam_role_info_module.htmlMcollections/community/aws/iam_role_module.htmlMcollections/community/aws/iam_saml_federation_module.htmlMcollections/community/aws/iam_server_certificate_info_module.htmlMcollections/community/aws/iam_server_certificate_module.htmlMcollections/community/aws/iam_user_info_module.htmlMcollections/community/aws/iam_user_module.htmlMcollections/community/aws/index.htmlMcollections/community/aws/kinesis_stream_module.htmlMcollections/community/aws/lambda_alias_module.htmlMcollections/community/aws/lambda_event_module.htmlMcollections/community/aws/lambda_info_module.htmlMcollections/community/aws/lambda_module.htmlMcollections/community/aws/lambda_policy_module.htmlMcollections/community/aws/lightsail_module.htmlMcollections/community/aws/rds_instance_info_module.htmlMcollections/community/aws/rds_instance_module.htmlMcollections/community/aws/rds_instance_snapshot_module.htmlMcollections/community/aws/rds_option_group_info_module.htmlMcollections/community/aws/rds_option_group_module.htmlMcollections/community/aws/rds_param_group_module.htmlMcollections/community/aws/rds_snapshot_info_module.htmlMcollections/community/aws/rds_snapshot_module.htmlMcollections/community/aws/rds_subnet_group_module.htmlMcollections/community/aws/redshift_cross_region_snapshots_module.htmlMcollections/community/aws/redshift_info_module.htmlMcollections/community/aws/redshift_module.htmlMcollections/community/aws/redshift_subnet_group_module.htmlMcollections/community/aws/route53_health_check_module.htmlMcollections/community/aws/route53_info_module.htmlMcollections/community/aws/route53_module.htmlMcollections/community/aws/route53_zone_module.htmlMcollections/community/aws/s3_bucket_notification_module.htmlMcollections/community/aws/s3_lifecycle_module.htmlMcollections/community/aws/s3_logging_module.htmlMcollections/community/aws/s3_metrics_configuration_module.htmlMcollections/community/aws/s3_sync_module.htmlMcollections/community/aws/s3_website_module.htmlMcollections/community/aws/sns_module.htmlMcollections/community/aws/sns_topic_module.htmlMcollections/community/aws/sqs_queue_module.htmlMcollections/community/aws/sts_assume_role_module.htmlMcollections/community/aws/sts_session_token_module.htmlMcollections/community/aws/wafv2_ip_set_info_module.htmlMcollections/community/aws/wafv2_ip_set_module.htmlMcollections/community/aws/wafv2_resources_info_module.htmlMcollections/community/aws/wafv2_resources_module.htmlMcollections/community/aws/wafv2_rule_group_info_module.htmlMcollections/community/aws/wafv2_rule_group_module.htmlMcollections/community/aws/wafv2_web_acl_info_module.htmlMcollections/community/aws/wafv2_web_acl_module.htmlMcollections/index_module.html R056 /home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/iam_module.html /home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/eks_fargate_profile_module.html R057 /home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/ec2_elb_info_module.html /home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/ec2_asg_instance_refresh_info_module.html R062 /home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/lambda_facts_module.html /home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/aws_api_gateway_domain_module.html
Click to see the diff comparison.
NOTE: only file modifications are shown here. New and deleted files are excluded. See the file list and check the published docs to see those files.
The diff output was truncated because it exceeded the maximum size.
diff --git a/home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/aws_acm_info_module.html b/home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/aws_acm_info_module.html
index 9538264..1bdee97 100644
--- a/home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/aws_acm_info_module.html
+++ b/home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/aws_acm_info_module.html
@@ -21,7 +21,7 @@
<script src="../../../_static/js/theme.js"></script>
<link rel="search" title="Search" href="../../../search.html" />
<link rel="next" title="community.aws.aws_api_gateway module β Manage AWS API Gateway APIs" href="aws_api_gateway_module.html" />
- <link rel="prev" title="community.aws.aws_acm module β Upload and delete certificates in the AWS Certificate Manager service" href="aws_acm_module.html" /><!-- extra head elements for Ansible beyond RTD Sphinx Theme -->
+ <link rel="prev" title="Synopsis" href="aws_acm_module.html" /><!-- extra head elements for Ansible beyond RTD Sphinx Theme -->
@@ -121,7 +121,7 @@
<h1>community.aws.aws_acm_info module β Retrieve certificate information from AWS Certificate Manager service<a class="headerlink" href="#community-aws-aws-acm-info-module-retrieve-certificate-information-from-aws-certificate-manager-service" title="Permalink to this headline">ο</a></h1>
<div class="admonition note">
<p class="admonition-title">Note</p>
-<p>This module is part of the <a class="reference external" href="https://galaxy.ansible.com/community/aws">community.aws collection</a> (version 2.0.0).</p>
+<p>This module is part of the <a class="reference external" href="https://galaxy.ansible.com/community/aws">community.aws collection</a> (version 4.0.0-dev0).</p>
<p>You might already have this collection installed if you are using the <code class="docutils literal notranslate"><span class="pre">ansible</span></code> package.
It is not included in <code class="docutils literal notranslate"><span class="pre">ansible-core</span></code>.
To check whether it is installed, run <code class="code docutils literal notranslate"><span class="pre">ansible-galaxy</span> <span class="pre">collection</span> <span class="pre">list</span></code>.</p>
@@ -145,7 +145,6 @@ To check whether it is installed, run <code class="code docutils literal notrans
<h2><a class="toc-backref" href="#id1">Synopsis</a><a class="headerlink" href="#synopsis" title="Permalink to this headline">ο</a></h2>
<ul class="simple">
<li><p>Retrieve information for ACM certificates</p></li>
-<li><p>This module was called <code class="docutils literal notranslate"><span class="pre">aws_acm_facts</span></code> before Ansible 2.9. The usage did not change.</p></li>
<li><p>Note that this will not return information about uploaded keys of size 4096 bits, due to a limitation of the ACM API.</p></li>
</ul>
</section>
@@ -697,7 +696,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
- <a href="aws_acm_module.html" class="btn btn-neutral float-left" title="community.aws.aws_acm module β Upload and delete certificates in the AWS Certificate Manager service" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+ <a href="aws_acm_module.html" class="btn btn-neutral float-left" title="Synopsis" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="aws_api_gateway_module.html" class="btn btn-neutral float-right" title="community.aws.aws_api_gateway module β Manage AWS API Gateway APIs" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
diff --git a/home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/aws_acm_module.html b/home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/aws_acm_module.html
index ce7bf0c..acae62f 100644
--- a/home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/aws_acm_module.html
+++ b/home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/aws_acm_module.html
@@ -4,7 +4,7 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>community.aws.aws_acm module β Upload and delete certificates in the AWS Certificate Manager service — Ansible collections documentation</title>
+ <title>Synopsis — Ansible collections documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/ansible.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/antsibull-minimal.css" type="text/css" />
@@ -106,7 +106,7 @@
<li><a href="../../index.html">Collection Index</a> »</li>
<li><a href="../index.html">Collections in the Community Namespace</a> »</li>
<li><a href="index.html">Community.Aws</a> »</li>
- <li>community.aws.aws_acm module β Upload and delete certificates in the AWS Certificate Manager service</li>
+ <li>Synopsis</li>
<li class="wy-breadcrumbs-aside">
</li>
</ul>
@@ -117,11 +117,11 @@
<div itemprop="articleBody">
- <span class="target" id="ansible-collections-community-aws-aws-acm-module"></span><section id="community-aws-aws-acm-module-upload-and-delete-certificates-in-the-aws-certificate-manager-service">
-<h1>community.aws.aws_acm module β Upload and delete certificates in the AWS Certificate Manager service<a class="headerlink" href="#community-aws-aws-acm-module-upload-and-delete-certificates-in-the-aws-certificate-manager-service" title="Permalink to this headline">ο</a></h1>
+ <span class="target" id="ansible-collections-community-aws-aws-acm-module"></span><p>community.aws.aws_acm module β Upload and delete certificates in the AWS Certificate Manager service</p>
+<hr class="docutils" />
<div class="admonition note">
<p class="admonition-title">Note</p>
-<p>This module is part of the <a class="reference external" href="https://galaxy.ansible.com/community/aws">community.aws collection</a> (version 2.0.0).</p>
+<p>This module is part of the <a class="reference external" href="https://galaxy.ansible.com/community/aws">community.aws collection</a> (version 4.0.0-dev0).</p>
<p>You might already have this collection installed if you are using the <code class="docutils literal notranslate"><span class="pre">ansible</span></code> package.
It is not included in <code class="docutils literal notranslate"><span class="pre">ansible-core</span></code>.
To check whether it is installed, run <code class="code docutils literal notranslate"><span class="pre">ansible-galaxy</span> <span class="pre">collection</span> <span class="pre">list</span></code>.</p>
@@ -142,7 +142,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
</ul>
</div>
<section id="synopsis">
-<h2><a class="toc-backref" href="#id1">Synopsis</a><a class="headerlink" href="#synopsis" title="Permalink to this headline">ο</a></h2>
+<h1><a class="toc-backref" href="#id1">Synopsis</a><a class="headerlink" href="#synopsis" title="Permalink to this headline">ο</a></h1>
<ul class="simple">
<li><p>Import and delete certificates in Amazon Web Serviceβs Certificate Manager (AWS ACM).</p></li>
<li><p>This module does not currently interact with AWS-provided certificates. It currently only manages certificates provided to AWS by the user.</p></li>
@@ -157,7 +157,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
</ul>
</section>
<section id="requirements">
-<h2><a class="toc-backref" href="#id2">Requirements</a><a class="headerlink" href="#requirements" title="Permalink to this headline">ο</a></h2>
+<h1><a class="toc-backref" href="#id2">Requirements</a><a class="headerlink" href="#requirements" title="Permalink to this headline">ο</a></h1>
<p>The below requirements are needed on the host that executes this module.</p>
<ul class="simple">
<li><p>python >= 3.6</p></li>
@@ -166,7 +166,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
</ul>
</section>
<section id="parameters">
-<h2><a class="toc-backref" href="#id3">Parameters</a><a class="headerlink" href="#parameters" title="Permalink to this headline">ο</a></h2>
+<h1><a class="toc-backref" href="#id3">Parameters</a><a class="headerlink" href="#parameters" title="Permalink to this headline">ο</a></h1>
<table class="colwidths-auto ansible-option-table docutils align-default" style="width: 100%">
<thead>
<tr class="row-odd"><th class="head"><p>Parameter</p></th>
@@ -221,7 +221,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
<a class="ansibleOptionLink" href="#parameter-certificate" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
</div></td>
<td><div class="ansible-option-cell"><p>The body of the PEM encoded public certificate.</p>
-<p>Required when <em>state</em> is not <code class="docutils literal notranslate"><span class="pre">absent</span></code>.</p>
+<p>Required when <em>state</em> is not <code class="docutils literal notranslate"><span class="pre">absent</span></code> and the certificate does not exist.</p>
<p>If your certificate is in a file, use <code class="docutils literal notranslate"><span class="pre">lookup('file',</span> <span class="pre">'path/to/cert.pem'</span></code>).</p>
</div></td>
</tr>
@@ -231,8 +231,8 @@ To check whether it is installed, run <code class="code docutils literal notrans
<a class="ansibleOptionLink" href="#parameter-certificate_arn" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-aliases">aliases: arn</span></p>
<p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
</div></td>
-<td><div class="ansible-option-cell"><p>The ARN of a certificate in ACM to delete</p>
-<p>Ignored when <em>state=present</em>.</p>
+<td><div class="ansible-option-cell"><p>The ARN of a certificate in ACM to modify or delete.</p>
+<p>If <em>state=present</em>, the certificate with the specified ARN can be updated. For example, this can be used to add/remove tags to an existing certificate.</p>
<p>If <em>state=absent</em>, you must provide one of <em>certificate_arn</em>, <em>domain_name</em> or <em>name_tag</em>.</p>
<p>If <em>state=absent</em> and no resource exists with this ARN in this region, the task will succeed with no effect.</p>
<p>If <em>state=absent</em> and the corresponding resource exists in a different region, this task may report success without deleting that resource.</p>
@@ -267,7 +267,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
</div></td>
<td><div class="ansible-option-cell"><p>The domain name of the certificate.</p>
<p>If <em>state=absent</em> and <em>domain_name</em> is specified, this task will delete all ACM certificates with this domain.</p>
-<p>Exactly one of <em>domain_name</em>, <em>name_tag</em> and <em>certificate_arn</em> must be provided.</p>
+<p>Exactly one of <em>domain_name</em>, <em>name_tag</em> and <em>certificate_arn</em> must be provided.</p>
<p>If <em>state=present</em> this must not be specified. (Since the domain name is encoded within the public certificateβs body.)</p>
</div></td>
</tr>
@@ -291,6 +291,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
<p>This can be any set of characters accepted by AWS for tag values.</p>
<p>This is to ensure Ansible can treat certificates idempotently, even though the ACM API allows duplicate certificates.</p>
<p>If <em>state=preset</em>, this must be specified.</p>
+<p>If <em>state=absent</em> and <em>name_tag</em> is specified, this task will delete all ACM certificates with this Name tag.</p>
<p>If <em>state=absent</em>, you must provide exactly one of <em>certificate_arn</em>, <em>domain_name</em> or <em>name_tag</em>.</p>
</div></td>
</tr>
@@ -299,7 +300,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
<a class="ansibleOptionLink" href="#parameter-private_key" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
</div></td>
<td><div class="ansible-option-cell"><p>The body of the PEM encoded private key.</p>
-<p>Required when <em>state=present</em>.</p>
+<p>Required when <em>state=present</em> and the certificate does not exist.</p>
<p>Ignored when <em>state=absent</em>.</p>
<p>If your private key is in a file, use <code class="docutils literal notranslate"><span class="pre">lookup('file',</span> <span class="pre">'path/to/key.pem'</span></code>).</p>
</div></td>
@@ -315,6 +316,19 @@ To check whether it is installed, run <code class="code docutils literal notrans
</div></td>
</tr>
<tr class="row-odd"><td><div class="ansible-option-cell">
+<div class="ansibleOptionAnchor" id="parameter-purge_tags"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-acm-module-parameter-purge-tags"><strong>purge_tags</strong></p>
+<a class="ansibleOptionLink" href="#parameter-purge_tags" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">boolean</span></p>
+<p><span class="ansible-option-versionadded">added in 3.2.0 of community.aws</span></p>
+</div></td>
+<td><div class="ansible-option-cell"><p>whether to remove tags not present in the <code class="docutils literal notranslate"><span class="pre">tags</span></code> parameter.</p>
+<p class="ansible-option-line"><span class="ansible-option-choices">Choices:</span></p>
+<ul class="simple">
+<li><p><span class="ansible-option-default-bold">no</span> <span class="ansible-option-default">β (default)</span></p></li>
+<li><p><span class="ansible-option-choices-entry">yes</span></p></li>
+</ul>
+</div></td>
+</tr>
+<tr class="row-even"><td><div class="ansible-option-cell">
<div class="ansibleOptionAnchor" id="parameter-region"></div>
<div class="ansibleOptionAnchor" id="parameter-aws_region"></div>
<div class="ansibleOptionAnchor" id="parameter-ec2_region"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-acm-module-parameter-region"><span id="ansible-collections-community-aws-aws-acm-module-parameter-ec2-region"></span><span id="ansible-collections-community-aws-aws-acm-module-parameter-aws-region"></span><strong>region</strong></p>
@@ -324,7 +338,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
<td><div class="ansible-option-cell"><p>The AWS region to use. If not specified then the value of the AWS_REGION or EC2_REGION environment variable, if any, is used. See <a class="reference external" href="http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region">http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region</a></p>
</div></td>
</tr>
-<tr class="row-even"><td><div class="ansible-option-cell">
+<tr class="row-odd"><td><div class="ansible-option-cell">
<div class="ansibleOptionAnchor" id="parameter-security_token"></div>
<div class="ansibleOptionAnchor" id="parameter-aws_security_token"></div>
<div class="ansibleOptionAnchor" id="parameter-access_token"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-acm-module-parameter-security-token"><span id="ansible-collections-community-aws-aws-acm-module-parameter-aws-security-token"></span><span id="ansible-collections-community-aws-aws-acm-module-parameter-access-token"></span><strong>security_token</strong></p>
@@ -336,7 +350,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
<p>Passing the <em>security_token</em> and <em>profile</em> options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01.</p>
</div></td>
</tr>
-<tr class="row-odd"><td><div class="ansible-option-cell">
+<tr class="row-even"><td><div class="ansible-option-cell">
<div class="ansibleOptionAnchor" id="parameter-state"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-acm-module-parameter-state"><strong>state</strong></p>
<a class="ansibleOptionLink" href="#parameter-state" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
</div></td>
@@ -349,6 +363,16 @@ To check whether it is installed, run <code class="code docutils literal notrans
</ul>
</div></td>
</tr>
+<tr class="row-odd"><td><div class="ansible-option-cell">
+<div class="ansibleOptionAnchor" id="parameter-tags"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-acm-module-parameter-tags"><strong>tags</strong></p>
+<a class="ansibleOptionLink" href="#parameter-tags" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">dictionary</span></p>
+<p><span class="ansible-option-versionadded">added in 3.2.0 of community.aws</span></p>
+</div></td>
+<td><div class="ansible-option-cell"><p>Tags to apply to certificates imported in ACM.</p>
+<p>If both <em>name_tag</em> and the βNameβ tag in <em>tags</em> are set, the values must be the same.</p>
+<p>If the βNameβ tag in <em>tags</em> is not set and <em>name_tag</em> is set, the <em>name_tag</em> value is copied to <em>tags</em>.</p>
+</div></td>
+</tr>
<tr class="row-even"><td><div class="ansible-option-cell">
<div class="ansibleOptionAnchor" id="parameter-validate_certs"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-acm-module-parameter-validate-certs"><strong>validate_certs</strong></p>
<a class="ansibleOptionLink" href="#parameter-validate_certs" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">boolean</span></p>
@@ -365,7 +389,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
</table>
</section>
<section id="notes">
-<h2><a class="toc-backref" href="#id4">Notes</a><a class="headerlink" href="#notes" title="Permalink to this headline">ο</a></h2>
+<h1><a class="toc-backref" href="#id4">Notes</a><a class="headerlink" href="#notes" title="Permalink to this headline">ο</a></h1>
<div class="admonition note">
<p class="admonition-title">Note</p>
<ul class="simple">
@@ -377,7 +401,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
</div>
</section>
<section id="examples">
-<h2><a class="toc-backref" href="#id5">Examples</a><a class="headerlink" href="#examples" title="Permalink to this headline">ο</a></h2>
+<h1><a class="toc-backref" href="#id5">Examples</a><a class="headerlink" href="#examples" title="Permalink to this headline">ο</a></h1>
<div class="highlight-yaml+jinja notranslate"><div class="highlight"><pre><span></span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">upload a self-signed certificate</span><span class="w"></span>
<span class="w"> </span><span class="nt">community.aws.aws_acm</span><span class="p">:</span><span class="w"></span>
<span class="w"> </span><span class="nt">certificate</span><span class="p">:</span><span class="w"> </span><span class="s">"</span><span class="cp">{{</span> <span class="nv">lookup</span><span class="o">(</span><span class="s1">'file'</span><span class="o">,</span> <span class="s1">'cert.pem'</span> <span class="o">)</span> <span class="cp">}}</span><span class="s">"</span><span class="w"></span>
@@ -388,7 +412,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
<span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">create/update a certificate with a chain</span><span class="w"></span>
<span class="w"> </span><span class="nt">community.aws.aws_acm</span><span class="p">:</span><span class="w"></span>
<span class="w"> </span><span class="nt">certificate</span><span class="p">:</span><span class="w"> </span><span class="s">"</span><span class="cp">{{</span> <span class="nv">lookup</span><span class="o">(</span><span class="s1">'file'</span><span class="o">,</span> <span class="s1">'cert.pem'</span> <span class="o">)</span> <span class="cp">}}</span><span class="s">"</span><span class="w"></span>
-<span class="w"> </span><span class="nt">privateKey</span><span class="p">:</span><span class="w"> </span><span class="s">"</span><span class="cp">{{</span> <span class="nv">lookup</span><span class="o">(</span><span class="s1">'file'</span><span class="o">,</span> <span class="s1">'key.pem'</span> <span class="o">)</span> <span class="cp">}}</span><span class="s">"</span><span class="w"></span>
+<span class="w"> </span><span class="nt">private_key</span><span class="p">:</span><span class="w"> </span><span class="s">"</span><span class="cp">{{</span> <span class="nv">lookup</span><span class="o">(</span><span class="s1">'file'</span><span class="o">,</span> <span class="s1">'key.pem'</span> <span class="o">)</span> <span class="cp">}}</span><span class="s">"</span><span class="w"></span>
<span class="w"> </span><span class="nt">name_tag</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my_cert</span><span class="w"></span>
<span class="w"> </span><span class="nt">certificate_chain</span><span class="p">:</span><span class="w"> </span><span class="s">"</span><span class="cp">{{</span> <span class="nv">lookup</span><span class="o">(</span><span class="s1">'file'</span><span class="o">,</span> <span class="s1">'chain.pem'</span> <span class="o">)</span> <span class="cp">}}</span><span class="s">"</span><span class="w"></span>
<span class="w"> </span><span class="nt">state</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">present</span><span class="w"></span>
@@ -416,11 +440,20 @@ To check whether it is installed, run <code class="code docutils literal notrans
<span class="w"> </span><span class="nt">domain_name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">acm.ansible.com</span><span class="w"></span>
<span class="w"> </span><span class="nt">state</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">absent</span><span class="w"></span>
<span class="w"> </span><span class="nt">region</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ap-southeast-2</span><span class="w"></span>
+
+<span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">add tags to an existing certificate with a particular ARN</span><span class="w"></span>
+<span class="w"> </span><span class="nt">community.aws.aws_acm</span><span class="p">:</span><span class="w"></span>
+<span class="w"> </span><span class="nt">certificate_arn</span><span class="p">:</span><span class="w"> </span><span class="s">"arn:aws:acm:ap-southeast-2:123456789012:certificate/01234567-abcd-abcd-abcd-012345678901"</span><span class="w"></span>
+<span class="w"> </span><span class="nt">tags</span><span class="p">:</span><span class="w"></span>
+<span class="w"> </span><span class="nt">Name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">my_certificate</span><span class="w"></span>
+<span class="w"> </span><span class="nt">Application</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">search</span><span class="w"></span>
+<span class="w"> </span><span class="nt">Environment</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">development</span><span class="w"></span>
+<span class="w"> </span><span class="nt">purge_tags</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span><span class="w"></span>
</pre></div>
</div>
</section>
<section id="return-values">
-<h2><a class="toc-backref" href="#id6">Return Values</a><a class="headerlink" href="#return-values" title="Permalink to this headline">ο</a></h2>
+<h1><a class="toc-backref" href="#id6">Return Values</a><a class="headerlink" href="#return-values" title="Permalink to this headline">ο</a></h1>
<p>Common return values are documented <a class="reference external" href="https://docs.ansible.com/ansible/devel/reference_appendices/common_return_values.html#common-return-values" title="(in Ansible vdevel)"><span class="xref std std-ref">here</span></a>, the following are the fields unique to this module:</p>
<table class="colwidths-auto ansible-option-table docutils align-default" style="width: 100%">
<thead>
@@ -467,18 +500,17 @@ To check whether it is installed, run <code class="code docutils literal notrans
</tbody>
</table>
<section id="authors">
-<h3>Authors<a class="headerlink" href="#authors" title="Permalink to this headline">ο</a></h3>
+<h2>Authors<a class="headerlink" href="#authors" title="Permalink to this headline">ο</a></h2>
<ul class="simple">
<li><p>Matthew Davis (@matt-telstra) on behalf of Telstra Corporation Limited</p></li>
</ul>
</section>
<section id="collection-links">
-<h3>Collection links<a class="headerlink" href="#collection-links" title="Permalink to this headline">ο</a></h3>
+<h2>Collection links<a class="headerlink" href="#collection-links" title="Permalink to this headline">ο</a></h2>
<p class="ansible-links">
<a href="https://github.com/ansible-collections/community.aws/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc" aria-role="button" target="_blank" rel="noopener external">Issue Tracker</a>
<a href="https://github.com/ansible-collections/community.aws" aria-role="button" target="_blank" rel="noopener external">Repository (Sources)</a>
</p></section>
-</section>
</section>
diff --git a/home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/lambda_facts_module.html b/home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/aws_api_gateway_domain_module.html
similarity index 62%
rename from /home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/lambda_facts_module.html
rename to /home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/aws_api_gateway_domain_module.html
index c3d7939..b526712 100644
--- a/home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/lambda_facts_module.html
+++ b/home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/aws_api_gateway_domain_module.html
@@ -4,7 +4,7 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>community.aws.lambda_facts module β Gathers AWS Lambda function details as Ansible facts — Ansible collections documentation</title>
+ <title>community.aws.aws_api_gateway_domain module β Manage AWS API Gateway custom domains — Ansible collections documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/ansible.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/antsibull-minimal.css" type="text/css" />
@@ -20,8 +20,8 @@
<script src="../../../_static/doctools.js"></script>
<script src="../../../_static/js/theme.js"></script>
<link rel="search" title="Search" href="../../../search.html" />
- <link rel="next" title="community.aws.lambda_info module β Gathers AWS Lambda function details" href="lambda_info_module.html" />
- <link rel="prev" title="community.aws.lambda_event module β Creates, updates or deletes AWS Lambda function event mappings" href="lambda_event_module.html" /><!-- extra head elements for Ansible beyond RTD Sphinx Theme -->
+ <link rel="next" title="community.aws.aws_application_scaling_policy module β Manage Application Auto Scaling Scaling Policies" href="aws_application_scaling_policy_module.html" />
+ <link rel="prev" title="community.aws.aws_api_gateway module β Manage AWS API Gateway APIs" href="aws_api_gateway_module.html" /><!-- extra head elements for Ansible beyond RTD Sphinx Theme -->
@@ -106,7 +106,7 @@
<li><a href="../../index.html">Collection Index</a> »</li>
<li><a href="../index.html">Collections in the Community Namespace</a> »</li>
<li><a href="index.html">Community.Aws</a> »</li>
- <li>community.aws.lambda_facts module β Gathers AWS Lambda function details as Ansible facts</li>
+ <li>community.aws.aws_api_gateway_domain module β Manage AWS API Gateway custom domains</li>
<li class="wy-breadcrumbs-aside">
</li>
</ul>
@@ -117,54 +117,39 @@
<div itemprop="articleBody">
- <span class="target" id="ansible-collections-community-aws-lambda-facts-module"></span><section id="community-aws-lambda-facts-module-gathers-aws-lambda-function-details-as-ansible-facts">
-<h1>community.aws.lambda_facts module β Gathers AWS Lambda function details as Ansible facts<a class="headerlink" href="#community-aws-lambda-facts-module-gathers-aws-lambda-function-details-as-ansible-facts" title="Permalink to this headline">ο</a></h1>
+ <span class="target" id="ansible-collections-community-aws-aws-api-gateway-domain-module"></span><section id="community-aws-aws-api-gateway-domain-module-manage-aws-api-gateway-custom-domains">
+<h1>community.aws.aws_api_gateway_domain module β Manage AWS API Gateway custom domains<a class="headerlink" href="#community-aws-aws-api-gateway-domain-module-manage-aws-api-gateway-custom-domains" title="Permalink to this headline">ο</a></h1>
<div class="admonition note">
<p class="admonition-title">Note</p>
-<p>This module is part of the <a class="reference external" href="https://galaxy.ansible.com/community/aws">community.aws collection</a> (version 2.0.0).</p>
+<p>This module is part of the <a class="reference external" href="https://galaxy.ansible.com/community/aws">community.aws collection</a> (version 4.0.0-dev0).</p>
<p>You might already have this collection installed if you are using the <code class="docutils literal notranslate"><span class="pre">ansible</span></code> package.
It is not included in <code class="docutils literal notranslate"><span class="pre">ansible-core</span></code>.
To check whether it is installed, run <code class="code docutils literal notranslate"><span class="pre">ansible-galaxy</span> <span class="pre">collection</span> <span class="pre">list</span></code>.</p>
<p>To install it, use: <code class="code docutils literal notranslate"><span class="pre">ansible-galaxy</span> <span class="pre">collection</span> <span class="pre">install</span> <span class="pre">community.aws</span></code>.</p>
-<p>To use it in a playbook, specify: <code class="code docutils literal notranslate"><span class="pre">community.aws.lambda_facts</span></code>.</p>
+<p>To use it in a playbook, specify: <code class="code docutils literal notranslate"><span class="pre">community.aws.aws_api_gateway_domain</span></code>.</p>
</div>
<div class="versionadded">
-<p><span class="versionmodified added">New in version 1.0.0: </span>of community.aws</p>
+<p><span class="versionmodified added">New in version 3.3.0: </span>of community.aws</p>
</div>
<div class="contents local topic" id="contents">
<ul class="simple">
-<li><p><a class="reference internal" href="#deprecated" id="id1">DEPRECATED</a></p></li>
-<li><p><a class="reference internal" href="#synopsis" id="id2">Synopsis</a></p></li>
-<li><p><a class="reference internal" href="#requirements" id="id3">Requirements</a></p></li>
-<li><p><a class="reference internal" href="#parameters" id="id4">Parameters</a></p></li>
-<li><p><a class="reference internal" href="#notes" id="id5">Notes</a></p></li>
-<li><p><a class="reference internal" href="#examples" id="id6">Examples</a></p></li>
-<li><p><a class="reference internal" href="#return-values" id="id7">Return Values</a></p></li>
-<li><p><a class="reference internal" href="#status" id="id8">Status</a></p></li>
+<li><p><a class="reference internal" href="#synopsis" id="id1">Synopsis</a></p></li>
+<li><p><a class="reference internal" href="#requirements" id="id2">Requirements</a></p></li>
+<li><p><a class="reference internal" href="#parameters" id="id3">Parameters</a></p></li>
+<li><p><a class="reference internal" href="#notes" id="id4">Notes</a></p></li>
+<li><p><a class="reference internal" href="#examples" id="id5">Examples</a></p></li>
+<li><p><a class="reference internal" href="#return-values" id="id6">Return Values</a></p></li>
</ul>
</div>
-<section id="deprecated">
-<h2><a class="toc-backref" href="#id1">DEPRECATED</a><a class="headerlink" href="#deprecated" title="Permalink to this headline">ο</a></h2>
-<dl class="field-list simple">
-<dt class="field-odd">Removed in</dt>
-<dd class="field-odd"><p>major release after 2021-12-01</p>
-</dd>
-<dt class="field-even">Why</dt>
-<dd class="field-even"><p>Deprecated in favour of <code class="docutils literal notranslate"><span class="pre">_info</span></code> module.</p>
-</dd>
-<dt class="field-odd">Alternative</dt>
-<dd class="field-odd"><p>Use <a class="reference internal" href="lambda_info_module.html#ansible-collections-community-aws-lambda-info-module"><span class="std std-ref">community.aws.lambda_info</span></a> instead.</p>
-</dd>
-</dl>
-</section>
<section id="synopsis">
-<h2><a class="toc-backref" href="#id2">Synopsis</a><a class="headerlink" href="#synopsis" title="Permalink to this headline">ο</a></h2>
+<h2><a class="toc-backref" href="#id1">Synopsis</a><a class="headerlink" href="#synopsis" title="Permalink to this headline">ο</a></h2>
<ul class="simple">
-<li><p>Gathers various details related to Lambda functions, including aliases, versions and event source mappings. Use module <a class="reference internal" href="lambda_module.html#ansible-collections-community-aws-lambda-module"><span class="std std-ref">community.aws.lambda</span></a> to manage the lambda function itself, <a class="reference internal" href="lambda_alias_module.html#ansible-collections-community-aws-lambda-alias-module"><span class="std std-ref">community.aws.lambda_alias</span></a> to manage function aliases and <a class="reference internal" href="lambda_event_module.html#ansible-collections-community-aws-lambda-event-module"><span class="std std-ref">community.aws.lambda_event</span></a> to manage lambda event source mappings.</p></li>
+<li><p>Manages API Gateway custom domains for API GW Rest APIs.</p></li>
+<li><p>AWS API Gateway custom domain setups use CloudFront behind the scenes. So you will get a CloudFront distribution as a result, configured to be aliased with your domain.</p></li>
</ul>
</section>
<section id="requirements">
-<h2><a class="toc-backref" href="#id3">Requirements</a><a class="headerlink" href="#requirements" title="Permalink to this headline">ο</a></h2>
+<h2><a class="toc-backref" href="#id2">Requirements</a><a class="headerlink" href="#requirements" title="Permalink to this headline">ο</a></h2>
<p>The below requirements are needed on the host that executes this module.</p>
<ul class="simple">
<li><p>python >= 3.6</p></li>
@@ -173,7 +158,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
</ul>
</section>
<section id="parameters">
-<h2><a class="toc-backref" href="#id4">Parameters</a><a class="headerlink" href="#parameters" title="Permalink to this headline">ο</a></h2>
+<h2><a class="toc-backref" href="#id3">Parameters</a><a class="headerlink" href="#parameters" title="Permalink to this headline">ο</a></h2>
<table class="colwidths-auto ansible-option-table docutils align-default" style="width: 100%">
<thead>
<tr class="row-odd"><th class="head"><p>Parameter</p></th>
@@ -184,7 +169,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
<tr class="row-even"><td><div class="ansible-option-cell">
<div class="ansibleOptionAnchor" id="parameter-aws_access_key"></div>
<div class="ansibleOptionAnchor" id="parameter-ec2_access_key"></div>
-<div class="ansibleOptionAnchor" id="parameter-access_key"></div><p class="ansible-option-title" id="ansible-collections-community-aws-lambda-facts-module-parameter-ec2-access-key"><span id="ansible-collections-community-aws-lambda-facts-module-parameter-aws-access-key"></span><span id="ansible-collections-community-aws-lambda-facts-module-parameter-access-key"></span><strong>aws_access_key</strong></p>
+<div class="ansibleOptionAnchor" id="parameter-access_key"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-ec2-access-key"><span id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-aws-access-key"></span><span id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-access-key"></span><strong>aws_access_key</strong></p>
<a class="ansibleOptionLink" href="#parameter-aws_access_key" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-aliases">aliases: ec2_access_key, access_key</span></p>
<p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
</div></td>
@@ -194,7 +179,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
</div></td>
</tr>
<tr class="row-odd"><td><div class="ansible-option-cell">
-<div class="ansibleOptionAnchor" id="parameter-aws_ca_bundle"></div><p class="ansible-option-title" id="ansible-collections-community-aws-lambda-facts-module-parameter-aws-ca-bundle"><strong>aws_ca_bundle</strong></p>
+<div class="ansibleOptionAnchor" id="parameter-aws_ca_bundle"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-aws-ca-bundle"><strong>aws_ca_bundle</strong></p>
<a class="ansibleOptionLink" href="#parameter-aws_ca_bundle" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">path</span></p>
</div></td>
<td><div class="ansible-option-cell"><p>The location of a CA Bundle to use when validating SSL certificates.</p>
@@ -203,7 +188,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
</div></td>
</tr>
<tr class="row-even"><td><div class="ansible-option-cell">
-<div class="ansibleOptionAnchor" id="parameter-aws_config"></div><p class="ansible-option-title" id="ansible-collections-community-aws-lambda-facts-module-parameter-aws-config"><strong>aws_config</strong></p>
+<div class="ansibleOptionAnchor" id="parameter-aws_config"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-aws-config"><strong>aws_config</strong></p>
<a class="ansibleOptionLink" href="#parameter-aws_config" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">dictionary</span></p>
</div></td>
<td><div class="ansible-option-cell"><p>A dictionary to modify the botocore configuration.</p>
@@ -214,7 +199,7 @@ To check whether it is installed, run <code class="code docutils literal notrans
<tr class="row-odd"><td><div class="ansible-option-cell">
<div class="ansibleOptionAnchor" id="parameter-aws_secret_key"></div>
<div class="ansibleOptionAnchor" id="parameter-ec2_secret_key"></div>
-<div class="ansibleOptionAnchor" id="parameter-secret_key"></div><p class="ansible-option-title" id="ansible-collections-community-aws-lambda-facts-module-parameter-secret-key"><span id="ansible-collections-community-aws-lambda-facts-module-parameter-ec2-secret-key"></span><span id="ansible-collections-community-aws-lambda-facts-module-parameter-aws-secret-key"></span><strong>aws_secret_key</strong></p>
+<div class="ansibleOptionAnchor" id="parameter-secret_key"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-secret-key"><span id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-ec2-secret-key"></span><span id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-aws-secret-key"></span><strong>aws_secret_key</strong></p>
<a class="ansibleOptionLink" href="#parameter-aws_secret_key" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-aliases">aliases: ec2_secret_key, secret_key</span></p>
<p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
</div></td>
@@ -224,7 +209,14 @@ To check whether it is installed, run <code class="code docutils literal notrans
</div></td>
</tr>
<tr class="row-even"><td><div class="ansible-option-cell">
-<div class="ansibleOptionAnchor" id="parameter-debug_botocore_endpoint_logs"></div><p class="ansible-option-title" id="ansible-collections-community-aws-lambda-facts-module-parameter-debug-botocore-endpoint-logs"><strong>debug_botocore_endpoint_logs</strong></p>
+<div class="ansibleOptionAnchor" id="parameter-certificate_arn"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-certificate-arn"><strong>certificate_arn</strong></p>
+<a class="ansibleOptionLink" href="#parameter-certificate_arn" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">string</span> / <span class="ansible-option-required">required</span></p>
+</div></td>
+<td><div class="ansible-option-cell"><p>AWS Certificate Manger (ACM) TLS certificate ARN.</p>
+</div></td>
+</tr>
+<tr class="row-odd"><td><div class="ansible-option-cell">
+<div class="ansibleOptionAnchor" id="parameter-debug_botocore_endpoint_logs"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-debug-botocore-endpoint-logs"><strong>debug_botocore_endpoint_logs</strong></p>
<a class="ansibleOptionLink" href="#parameter-debug_botocore_endpoint_logs" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">boolean</span></p>
</div></td>
<td><div class="ansible-option-cell"><p>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.</p>
@@ -235,36 +227,49 @@ To check whether it is installed, run <code class="code docutils literal notrans
</ul>
</div></td>
</tr>
+<tr class="row-even"><td><div class="ansible-option-cell">
+<div class="ansibleOptionAnchor" id="parameter-domain_mappings"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-domain-mappings"><strong>domain_mappings</strong></p>
+<a class="ansibleOptionLink" href="#parameter-domain_mappings" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">list</span> / <span class="ansible-option-elements">elements=dictionary</span> / <span class="ansible-option-required">required</span></p>
+</div></td>
+<td><div class="ansible-option-cell"><p>Map your domain base paths to your API GW REST APIs, that you previously created. Use provided ID of the API setup and the release stage.</p>
+<p>domain_mappings should be a list of dictionaries containing three keys: base_path, rest_api_id and stage.</p>
+<p>Example: <em>[{ base_path: v1, rest_api_id: abc123, stage: production }]</em></p>
+<p>if you want base path to be just <em>/</em> omit the param completely or set it to empty string.</p>
+</div></td>
+</tr>
<tr class="row-odd"><td><div class="ansible-option-cell">
+<div class="ansibleOptionAnchor" id="parameter-domain_name"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-domain-name"><strong>domain_name</strong></p>
+<a class="ansibleOptionLink" href="#parameter-domain_name" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">string</span> / <span class="ansible-option-required">required</span></p>
+</div></td>
+<td><div class="ansible-option-cell"><p>Domain name you want to use for your API GW deployment.</p>
+</div></td>
+</tr>
+<tr class="row-even"><td><div class="ansible-option-cell">
<div class="ansibleOptionAnchor" id="parameter-ec2_url"></div>
<div class="ansibleOptionAnchor" id="parameter-aws_endpoint_url"></div>
-<div class="ansibleOptionAnchor" id="parameter-endpoint_url"></div><p class="ansible-option-title" id="ansible-collections-community-aws-lambda-facts-module-parameter-endpoint-url"><span id="ansible-collections-community-aws-lambda-facts-module-parameter-ec2-url"></span><span id="ansible-collections-community-aws-lambda-facts-module-parameter-aws-endpoint-url"></span><strong>ec2_url</strong></p>
+<div class="ansibleOptionAnchor" id="parameter-endpoint_url"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-endpoint-url"><span id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-ec2-url"></span><span id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-aws-endpoint-url"></span><strong>ec2_url</strong></p>
<a class="ansibleOptionLink" href="#parameter-ec2_url" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-aliases">aliases: aws_endpoint_url, endpoint_url</span></p>
<p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
</div></td>
<td><div class="ansible-option-cell"><p>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.</p>
</div></td>
</tr>
-<tr class="row-even"><td><div class="ansible-option-cell">
-<div class="ansibleOptionAnchor" id="parameter-event_source_arn"></div><p class="ansible-option-title" id="ansible-collections-community-aws-lambda-facts-module-parameter-event-source-arn"><strong>event_source_arn</strong></p>
-<a class="ansibleOptionLink" href="#parameter-event_source_arn" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
-</div></td>
-<td><div class="ansible-option-cell"><p>For query type βmappingsβ, this is the Amazon Resource Name (ARN) of the Amazon Kinesis or DynamoDB stream.</p>
-</div></td>
-</tr>
<tr class="row-odd"><td><div class="ansible-option-cell">
-<div class="ansibleOptionAnchor" id="parameter-function_name"></div>
-<div class="ansibleOptionAnchor" id="parameter-function"></div>
-<div class="ansibleOptionAnchor" id="parameter-name"></div><p class="ansible-option-title" id="ansible-collections-community-aws-lambda-facts-module-parameter-name"><span id="ansible-collections-community-aws-lambda-facts-module-parameter-function-name"></span><span id="ansible-collections-community-aws-lambda-facts-module-parameter-function"></span><strong>function_name</strong></p>
-<a class="ansibleOptionLink" href="#parameter-function_name" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-aliases">aliases: function, name</span></p>
-<p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
+<div class="ansibleOptionAnchor" id="parameter-endpoint_type"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-endpoint-type"><strong>endpoint_type</strong></p>
+<a class="ansibleOptionLink" href="#parameter-endpoint_type" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
</div></td>
-<td><div class="ansible-option-cell"><p>The name of the lambda function for which facts are requested.</p>
+<td><div class="ansible-option-cell"><p>API endpoint configuration for domain. Use EDGE for edge-optimized endpoint, or use <code class="docutils literal notranslate"><span class="pre">REGIONAL</span></code> or <code class="docutils literal notranslate"><span class="pre">PRIVATE</span></code>.</p>
+<p class="ansible-option-line"><span class="ansible-option-choices">Choices:</span></p>
+<ul class="simple">
+<li><p><span class="ansible-option-default-bold">EDGE</span> <span class="ansible-option-default">β (default)</span></p></li>
+<li><p><span class="ansible-option-choices-entry">REGIONAL</span></p></li>
+<li><p><span class="ansible-option-choices-entry">PRIVATE</span></p></li>
+</ul>
</div></td>
</tr>
<tr class="row-even"><td><div class="ansible-option-cell">
<div class="ansibleOptionAnchor" id="parameter-profile"></div>
-<div class="ansibleOptionAnchor" id="parameter-aws_profile"></div><p class="ansible-option-title" id="ansible-collections-community-aws-lambda-facts-module-parameter-profile"><span id="ansible-collections-community-aws-lambda-facts-module-parameter-aws-profile"></span><strong>profile</strong></p>
+<div class="ansibleOptionAnchor" id="parameter-aws_profile"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-profile"><span id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-aws-profile"></span><strong>profile</strong></p>
<a class="ansibleOptionLink" href="#parameter-profile" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-aliases">aliases: aws_profile</span></p>
<p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
</div></td>
@@ -273,35 +278,31 @@ To check whether it is installed, run <code class="code docutils literal notrans
</div></td>
</tr>
<tr class="row-odd"><td><div class="ansible-option-cell">
-<div class="ansibleOptionAnchor" id="parameter-query"></div><p class="ansible-option-title" id="ansible-collections-community-aws-lambda-facts-module-parameter-query"><strong>query</strong></p>
-<a class="ansibleOptionLink" href="#parameter-query" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
-</div></td>
-<td><div class="ansible-option-cell"><p>Specifies the resource type for which to gather facts. Leave blank to retrieve all facts.</p>
-<p class="ansible-option-line"><span class="ansible-option-choices">Choices:</span></p>
-<ul class="simple">
-<li><p><span class="ansible-option-choices-entry">aliases</span></p></li>
-<li><p><span class="ansible-option-default-bold">all</span> <span class="ansible-option-default">β (default)</span></p></li>
-<li><p><span class="ansible-option-choices-entry">config</span></p></li>
-<li><p><span class="ansible-option-choices-entry">mappings</span></p></li>
-<li><p><span class="ansible-option-choices-entry">policy</span></p></li>
-<li><p><span class="ansible-option-choices-entry">versions</span></p></li>
-</ul>
-</div></td>
-</tr>
-<tr class="row-even"><td><div class="ansible-option-cell">
<div class="ansibleOptionAnchor" id="parameter-region"></div>
<div class="ansibleOptionAnchor" id="parameter-aws_region"></div>
-<div class="ansibleOptionAnchor" id="parameter-ec2_region"></div><p class="ansible-option-title" id="ansible-collections-community-aws-lambda-facts-module-parameter-region"><span id="ansible-collections-community-aws-lambda-facts-module-parameter-ec2-region"></span><span id="ansible-collections-community-aws-lambda-facts-module-parameter-aws-region"></span><strong>region</strong></p>
+<div class="ansibleOptionAnchor" id="parameter-ec2_region"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-region"><span id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-ec2-region"></span><span id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-aws-region"></span><strong>region</strong></p>
<a class="ansibleOptionLink" href="#parameter-region" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-aliases">aliases: aws_region, ec2_region</span></p>
<p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
</div></td>
<td><div class="ansible-option-cell"><p>The AWS region to use. If not specified then the value of the AWS_REGION or EC2_REGION environment variable, if any, is used. See <a class="reference external" href="http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region">http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region</a></p>
</div></td>
</tr>
+<tr class="row-even"><td><div class="ansible-option-cell">
+<div class="ansibleOptionAnchor" id="parameter-security_policy"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-security-policy"><strong>security_policy</strong></p>
+<a class="ansibleOptionLink" href="#parameter-security_policy" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
+</div></td>
+<td><div class="ansible-option-cell"><p>Set allowed TLS versions through AWS defined policies. Currently only <code class="docutils literal notranslate"><span class="pre">TLS_1_0</span></code> and <code class="docutils literal notranslate"><span class="pre">TLS_1_2</span></code> are available.</p>
+<p class="ansible-option-line"><span class="ansible-option-choices">Choices:</span></p>
+<ul class="simple">
+<li><p><span class="ansible-option-choices-entry">TLS_1_0</span></p></li>
+<li><p><span class="ansible-option-default-bold">TLS_1_2</span> <span class="ansible-option-default">β (default)</span></p></li>
+</ul>
+</div></td>
+</tr>
<tr class="row-odd"><td><div class="ansible-option-cell">
<div class="ansibleOptionAnchor" id="parameter-security_token"></div>
<div class="ansibleOptionAnchor" id="parameter-aws_security_token"></div>
-<div class="ansibleOptionAnchor" id="parameter-access_token"></div><p class="ansible-option-title" id="ansible-collections-community-aws-lambda-facts-module-parameter-security-token"><span id="ansible-collections-community-aws-lambda-facts-module-parameter-aws-security-token"></span><span id="ansible-collections-community-aws-lambda-facts-module-parameter-access-token"></span><strong>security_token</strong></p>
+<div class="ansibleOptionAnchor" id="parameter-access_token"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-security-token"><span id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-aws-security-token"></span><span id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-access-token"></span><strong>security_token</strong></p>
<a class="ansibleOptionLink" href="#parameter-security_token" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-aliases">aliases: aws_security_token, access_token</span></p>
<p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
</div></td>
@@ -311,7 +312,19 @@ To check whether it is installed, run <code class="code docutils literal notrans
</div></td>
</tr>
<tr class="row-even"><td><div class="ansible-option-cell">
-<div class="ansibleOptionAnchor" id="parameter-validate_certs"></div><p class="ansible-option-title" id="ansible-collections-community-aws-lambda-facts-module-parameter-validate-certs"><strong>validate_certs</strong></p>
+<div class="ansibleOptionAnchor" id="parameter-state"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-state"><strong>state</strong></p>
+<a class="ansibleOptionLink" href="#parameter-state" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">string</span></p>
+</div></td>
+<td><div class="ansible-option-cell"><p>Create or delete custom domain setup.</p>
+<p class="ansible-option-line"><span class="ansible-option-choices">Choices:</span></p>
+<ul class="simple">
+<li><p><span class="ansible-option-default-bold">present</span> <span class="ansible-option-default">β (default)</span></p></li>
+<li><p><span class="ansible-option-choices-entry">absent</span></p></li>
+</ul>
+</div></td>
+</tr>
+<tr class="row-odd"><td><div class="ansible-option-cell">
+<div class="ansibleOptionAnchor" id="parameter-validate_certs"></div><p class="ansible-option-title" id="ansible-collections-community-aws-aws-api-gateway-domain-module-parameter-validate-certs"><strong>validate_certs</strong></p>
<a class="ansibleOptionLink" href="#parameter-validate_certs" title="Permalink to this option"></a><p class="ansible-option-type-line"><span class="ansible-option-type">boolean</span></p>
</div></td>
<td><div class="ansible-option-cell"><p>When set to βnoβ, SSL certificates will not be validated for communication with the AWS APIs.</p>
@@ -326,10 +339,12 @@ To check whether it is installed, run <code class="code docutils literal notrans
</table>
</section>
<section id="notes">
-<h2><a class="toc-backref" href="#id5">Notes</a><a class="headerlink" href="#notes" title="Permalink to this headline">ο</a></h2>
+<h2><a class="toc-backref" href="#id4">Notes</a><a class="headerlink" href="#notes" title="Permalink to this headline">ο</a></h2>
<div class="admonition note">
<p class="admonition-title">Note</p>
<ul class="simple">
+<li><p>Does not create a DNS entry on Route53, for that use the route53 module.</p></li>
+<li><p>Only supports TLS certificates from AWS ACM that can just be referenced by the ARN, while the AWS API still offers (deprecated) options to add own Certificates.</p></li>
<li><p>If parameters are not set within the module, the following environment variables can be used in decreasing order of precedence <code class="docutils literal notranslate"><span class="pre">AWS_URL</span></code> or <code class="docutils literal notranslate"><span class="pre">EC2_URL</span></code>, <code class="docutils literal notranslate"><span class="pre">AWS_PROFILE</span></code> or <code class="docutils literal notranslate"><span class="pre">AWS_DEFAULT_PROFILE</span></co
Build failed.
:x: ansible-galaxy-importer FAILURE in 5m 30s (non-voting) :heavy_check_mark: build-ansible-collection SUCCESS in 6m 17s :x: ansible-test-sanity-docker-devel FAILURE in 10m 37s (non-voting) :x: ansible-test-sanity-docker-milestone FAILURE in 11m 28s :heavy_check_mark: ansible-test-sanity-docker-stable-2.9 SUCCESS in 17m 22s :heavy_check_mark: ansible-test-sanity-docker-stable-2.11 SUCCESS in 14m 26s :heavy_check_mark: ansible-test-sanity-docker-stable-2.12 SUCCESS in 13m 07s :heavy_check_mark: ansible-test-units-community-aws-python38 SUCCESS in 7m 25s :heavy_check_mark: ansible-test-splitter SUCCESS in 4m 35s :warning: integration-community.aws-1 SKIPPED :warning: integration-community.aws-2 SKIPPED :warning: integration-community.aws-3 SKIPPED :warning: integration-community.aws-4 SKIPPED :warning: integration-community.aws-5 SKIPPED :warning: integration-community.aws-6 SKIPPED :warning: integration-community.aws-7 SKIPPED :warning: integration-community.aws-8 SKIPPED :warning: integration-community.aws-9 SKIPPED :warning: integration-community.aws-10 SKIPPED :warning: integration-community.aws-11 SKIPPED :warning: integration-community.aws-12 SKIPPED :warning: integration-community.aws-13 SKIPPED
Note: this issue fixes #637 (which appears closed, but actually this PR is the fix) I've implemented the PR on my collection install and test it against a newly created bucket (less than 1 month old) which had the same issue as described by #637 and it worked. Is there any chance this gets merged soon? As anybody with a newly created bucket for SSM connections is probably going to face the same problem.
Thanks for taking the time to submit this PR. It appears to have stalled out, and because I can't push to the branch I can't revive this.
The work has been revived in #1633 and will hopefully be available in 5.2.0 (Real Soon Now, honest)