# ionoscloud\_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

```hcl
data "ionoscloud_cdn_distribution" "example" {
  id = "distr_id"
}
```

### By Domain

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

### By Domain with Partial Match

```hcl
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](https://docs.ionos.com/sections-test/terraform/data-sources/certificate_manager_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.