ansible / ansible.builtin / v2.4.3.0-1 / module / cloudfront_facts Obtain facts about an AWS CloudFront distribution | "added in version" 2.3 of ansible.builtin" Authors: Willem van Ketwich (@wilvk) preview | supported by communityansible.builtin.cloudfront_facts (v2.4.3.0-1) — module
pip
Install with pip install ansible==2.4.3.0.post1
Gets information about an AWS CloudFront distribution
# Note: These examples do not set authentication details, see the AWS Guide for details. # Get a summary of distributions - cloudfront_facts: summary: true
# Get information about a distribution - cloudfront_facts: distribution: true distribution_id: my-cloudfront-distribution-id
# Get information about a distribution using the CNAME of the cloudfront distribution. - cloudfront_facts: distribution: true domain_name_alias: www.my-website.com
# Facts are published in ansible_facts['cloudfront'][<distribution_name>] - debug: msg: "{{ ansible_facts['cloudfront']['my-cloudfront-distribution-id'] }}"
- debug: msg: "{{ ansible_facts['cloudfront']['www.my-website.com'] }}"
# Get all information about an invalidation for a distribution. - cloudfront_facts: invalidation: true distribution_id: my-cloudfront-distribution-id invalidation_id: my-cloudfront-invalidation-id
# Get all information about a cloudfront origin access identity. - cloudfront_facts: origin_access_identity: true origin_access_identity_id: my-cloudfront-origin-access-identity-id
# Get all information about lists not requiring parameters (ie. list_origin_access_identities, list_distributions, list_streaming_distributions) - cloudfront_facts: origin_access_identity: true origin_access_identity_id: my-cloudfront-origin-access-identity-id
# Get all information about lists not requiring parameters (ie. list_origin_access_identities, list_distributions, list_streaming_distributions) - cloudfront_facts: all_lists: true
region: aliases: - aws_region - ec2_region description: - 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 U(http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region) type: str profile: aliases: - aws_profile description: - The I(profile) option is mutually exclusive with the I(aws_access_key), I(aws_secret_key) and I(security_token) options. type: str summary: default: false description: - Returns a summary of all distributions, streaming distributions and origin_access_identities. This is the default behaviour if no option is selected. required: false all_lists: default: false description: - Get all cloudfront lists that do not require parameters. required: false aws_config: description: - A dictionary to modify the botocore configuration. - Parameters can be found at U(https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config). type: dict web_acl_id: description: - Used with I(list_distributions_by_web_acl_id). required: false distribution: default: false description: - Get information about a distribution. Requires I(distribution_id) or I(domain_name_alias) to be specified. required: false endpoint_url: aliases: - ec2_url - aws_endpoint_url - s3_url description: - 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. type: str invalidation: default: false description: - Get information about an invalidation. Requires I(invalidation_id) to be specified. required: false aws_ca_bundle: description: - The location of a CA Bundle to use when validating SSL certificates. - 'Note: The CA Bundle is read ''module'' side and may need to be explicitly copied from the controller if not run locally.' type: path aws_access_key: aliases: - ec2_access_key - access_key description: - C(AWS access key). If not set then the value of the C(AWS_ACCESS_KEY_ID), C(AWS_ACCESS_KEY) or C(EC2_ACCESS_KEY) environment variable is used. - The I(aws_access_key) and I(profile) options are mutually exclusive. type: str aws_secret_key: aliases: - ec2_secret_key - secret_key description: - C(AWS secret key). If not set then the value of the C(AWS_SECRET_ACCESS_KEY), C(AWS_SECRET_KEY), or C(EC2_SECRET_KEY) environment variable is used. - The I(aws_secret_key) and I(profile) options are mutually exclusive. type: str security_token: aliases: - aws_session_token - session_token - aws_security_token - access_token description: - C(AWS STS security token). If not set then the value of the C(AWS_SECURITY_TOKEN) or C(EC2_SECURITY_TOKEN) environment variable is used. - The I(security_token) and I(profile) options are mutually exclusive. - Aliases I(aws_session_token) and I(session_token) have been added in version 3.2.0. type: str validate_certs: default: true description: - When set to "no", SSL certificates will not be validated for communication with the AWS APIs. type: bool distribution_id: description: - The id of the CloudFront distribution. Used with I(distribution), I(distribution_config), I(invalidation), I(streaming_distribution), I(streaming_distribution_config), I(list_invalidations). required: false invalidation_id: description: - The id of the invalidation to get information about. Used with I(invalidation). required: false domain_name_alias: description: - Can be used instead of I(distribution_id) - uses the aliased CNAME for the cloudfront distribution to get the distribution id where required. required: false list_distributions: default: false description: - Get a list of cloudfront distributions. required: false list_invalidations: default: false description: - Get a list of invalidations. Requires I(distribution_id) or I(domain_name_alias) to be specified. required: false distribution_config: default: false description: - Get the configuration information about a distribution. Requires I(distribution_id) or I(domain_name_alias) to be specified. required: false origin_access_identity: default: false description: - Get information about an origin access identity. Requires I(origin_access_identity_id) to be specified. required: false streaming_distribution: default: false description: - Get information about a specified RTMP distribution. Requires I(distribution_id) or I(domain_name_alias) to be specified. required: false origin_access_identity_id: description: - The id of the cloudfront origin access identity to get information about. required: false debug_botocore_endpoint_logs: default: 'no' description: - 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. type: bool list_streaming_distributions: default: false description: - Get a list of streaming distributions. required: false list_origin_access_identities: default: false description: - Get a list of cloudfront origin access identities. Requires I(origin_access_identity_id) to be set. required: false origin_access_identity_config: default: false description: - Get the configuration information about an origin access identity. Requires I(origin_access_identity_id) to be specified. required: false list_distributions_by_web_acl_id: default: false description: - Get a list of distributions using web acl id as a filter. Requires I(web_acl_id) to be set. required: false streaming_distribution_configuration: default: false description: - Get the configuration information about a specified RTMP distribution. Requires I(distribution_id) or I(domain_name_alias) to be specified. required: false
distribution: description: 'Facts about a cloudfront distribution. Requires I(distribution_id) or I(domain_name_alias) to be specified. Requires I(origin_access_identity_id) to be set. ' returned: only if distribution is true type: dict distribution_config: description: 'Facts about a cloudfront distribution''s config. Requires I(distribution_id) or I(domain_name_alias) to be specified. ' returned: only if I(distribution_config) is true type: dict invalidation: description: 'Describes the invalidation information for the distribution. Requires I(invalidation_id) to be specified and either I(distribution_id) or I(domain_name_alias.) ' returned: only if invalidation is true type: dict origin_access_identity: description: Describes the origin access identity information. Requires I(origin_access_identity_id) to be set. returned: only if I(origin_access_identity) is true type: dict origin_access_identity_configuration: description: Describes the origin access identity information configuration information. Requires I(origin_access_identity_id) to be set. returned: only if I(origin_access_identity_configuration) is true type: dict streaming_distribution: description: 'Describes the streaming information for the distribution. Requires I(distribution_id) or I(domain_name_alias) to be specified. ' returned: only if I(streaming_distribution) is true type: dict streaming_distribution_configuration: description: 'Describes the streaming configuration information for the distribution. Requires I(distribution_id) or I(domain_name_alias) to be specified. ' returned: only if I(streaming_distribution_configuration) is true type: dict summary: description: Gives a summary of distributions, streaming distributions and origin access identities. returned: as default or if summary is true type: dict