CDN Distribution

Get information on an CDN Distribution

The Distribution data source can be used to search for and return an existing Distributions. You can provide a string for the domain parameter which will be compared with provisioned Distributions. If a single match is found, it will be returned. If your search results in multiple matches, an error will be returned. When this happens, please refine your search and make sure that your resources have unique domains.

Example Usage

By Id

data "ionoscloud_cdn_distribution" "example" {
  id = <distr_id>
}

By Domain

data "ionoscloud_cdn_distribution" "example" {
  domain = "example.com"
}

By Domain with Partial Match

data "ionoscloud_cdn_distribution" "example" {
  domain    		= "example"
  partial_match = true
}

Argument Reference

• id - (Optional) ID of the distribution you want to search for.

• domain - (Optional) Domain of an existing distribution that you want to search for. Search by domain is case-insensitive. The whole resource domain is required if partial_match parameter is not set to true.

• partial_match - (Optional) Whether partial matching is allowed or not when using domain argument. Default value is false.

Either domain or id must be provided. If none, or both of domain and id are provided, the datasource will return an error.

Attributes Reference

The following attributes are returned by the datasource:

• domain - The domain of the distribution.

• certificate_id - The ID of the certificate to use for the distribution. You can create certificates with the certificate resource.

• routing_rules - The routing rules for the distribution.

  • scheme - The scheme of the routing rule.

  • prefix - The prefix of the routing rule.

  • upstream - A map of properties for the rule

    • host - The upstream host that handles the requests if not already cached. This host will be protected by the WAF if the option is enabled.

    • caching - Enable or disable caching. If enabled, the CDN will cache the responses from the upstream host. Subsequent requests for the same resource will be served from the cache.

    • waf - Enable or disable WAF to protect the upstream host.

    • sni_mode - The SNI (Server Name Indication) mode of the upstream. It supports two modes: 1) distribution: for outgoing connections to the upstream host, the CDN requires the upstream host to present a valid certificate that matches the configured domain of the CDN distribution; 2) origin: for outgoing connections to the upstream host, the CDN requires the upstream host to present a valid certificate that matches the configured upstream/origin hostname.

    • rate_limit_class - Rate limit class that will be applied to limit the number of incoming requests per IP.

    • geo_restrictions - A map of geo_restrictions

      • allow_list - List of allowed countries

      • block_list - List of blocked countries

• public_endpoint_v4 - IP of the distribution, it has to be included on the domain DNS Zone as A record.

• public_endpoint_v6 - IP of the distribution, it has to be included on the domain DNS Zone as AAAA record.

• resource_urn - Unique resource identifier.