---
title: Hostnames
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/terraform)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Hostnames

#### HostnamesSettingsTLS

#### resource cloudflare\_hostname\_tls\_setting

##### required Expand Collapse

setting\_id: String

The TLS Setting name. The value type depends on the setting:

- `ciphers`: value is an array of cipher suite strings (e.g., `["ECDHE-RSA-AES128-GCM-SHA256", "AES128-GCM-SHA256"]`).
- `min_tls_version`: value is a TLS version string ( `"1.0"`, `"1.1"`, `"1.2"`, or `"1.3"`).
- `http2`: value is `"on"` or `"off"`.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20setting_id>)

hostname: String

The hostname for which the tls settings are set.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20hostname>)

zone\_id: String

Identifier.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20zone_id>)

value: String

The TLS setting value. The type depends on the `setting_id` used in the request path:

- `ciphers`: an array of allowed cipher suite strings in BoringSSL format (e.g., `["ECDHE-RSA-AES128-GCM-SHA256", "AES128-GCM-SHA256"]`).
- `min_tls_version`: a string indicating the minimum TLS version — one of `"1.0"`, `"1.1"`, `"1.2"`, or `"1.3"` (e.g., `"1.2"`).
- `http2`: a string indicating whether HTTP/2 is enabled — `"on"` or `"off"` (e.g., `"on"`).

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20value>)

##### computed Expand Collapse

id: String

The TLS Setting name. The value type depends on the setting:

- `ciphers`: value is an array of cipher suite strings (e.g., `["ECDHE-RSA-AES128-GCM-SHA256", "AES128-GCM-SHA256"]`).
- `min_tls_version`: value is a TLS version string ( `"1.0"`, `"1.1"`, `"1.2"`, or `"1.3"`).
- `http2`: value is `"on"` or `"off"`.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20id>)

created\_at: Time

This is the time the tls setting was originally created for this hostname.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20created_at>)

status: String

Deployment status for the given tls setting.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20status>)

updated\_at: Time

This is the time the tls setting was updated.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20updated_at>)

### cloudflare\_hostname\_tls\_setting

Terraform

HTTPTypeScriptPythonGoTerraform

```
resource "cloudflare_hostname_tls_setting" "example_hostname_tls_setting" {
  zone_id = "023e105f4ecef8ad9ca31a8372d0c353"
  setting_id = "ciphers"
  hostname = "app.example.com"
  value = ["ECDHE-RSA-AES128-GCM-SHA256", "AES128-GCM-SHA256"]
}
```

#### data cloudflare\_hostname\_tls\_setting

##### required Expand Collapse

hostname: String

The hostname for which the tls settings are set.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20hostname>)

setting\_id: String

The TLS Setting name. The value type depends on the setting:

- `ciphers`: value is an array of cipher suite strings (e.g., `["ECDHE-RSA-AES128-GCM-SHA256", "AES128-GCM-SHA256"]`).
- `min_tls_version`: value is a TLS version string ( `"1.0"`, `"1.1"`, `"1.2"`, or `"1.3"`).
- `http2`: value is `"on"` or `"off"`.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20setting_id>)

zone\_id: String

Identifier.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20zone_id>)

##### computed Expand Collapse

created\_at: Time

This is the time the tls setting was originally created for this hostname.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20created_at>)

status: String

Deployment status for the given tls setting.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20status>)

updated\_at: Time

This is the time the tls setting was updated.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20updated_at>)

value: String

The TLS setting value. The type depends on the `setting_id` used in the request path:

- `ciphers`: an array of allowed cipher suite strings in BoringSSL format (e.g., `["ECDHE-RSA-AES128-GCM-SHA256", "AES128-GCM-SHA256"]`).
- `min_tls_version`: a string indicating the minimum TLS version — one of `"1.0"`, `"1.1"`, `"1.2"`, or `"1.3"` (e.g., `"1.2"`).
- `http2`: a string indicating whether HTTP/2 is enabled — `"on"` or `"off"` (e.g., `"on"`).

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20value>)

### cloudflare\_hostname\_tls\_setting

Terraform

HTTPTypeScriptPythonGoTerraform

```
data "cloudflare_hostname_tls_setting" "example_hostname_tls_setting" {
  zone_id = "023e105f4ecef8ad9ca31a8372d0c353"
  setting_id = "ciphers"
  hostname = "app.example.com"
}
```

#### data cloudflare\_hostname\_tls\_settings

##### required Expand Collapse

setting\_id: String

The TLS Setting name. The value type depends on the setting:

- `ciphers`: value is an array of cipher suite strings (e.g., `["ECDHE-RSA-AES128-GCM-SHA256", "AES128-GCM-SHA256"]`).
- `min_tls_version`: value is a TLS version string ( `"1.0"`, `"1.1"`, `"1.2"`, or `"1.3"`).
- `http2`: value is `"on"` or `"off"`.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20setting_id>)

zone\_id: String

Identifier.

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20zone_id>)

##### optional Expand Collapse

max\_items?: Int64

Max items to fetch, default: 1000

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20max_items>)

##### computed Expand Collapse

<details>

<summary>

result: List\[Attributes]

The items returned by the data source

</summary>

created\_at: Time

This is the time the tls setting was originally created for this hostname.

<a href="#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20created_at">Link to this property</a>

hostname: String

The hostname for which the tls settings are set.

<a href="#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20hostname">Link to this property</a>

status: String

Deployment status for the given tls setting.

<a href="#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20status">Link to this property</a>

updated\_at: Time

This is the time the tls setting was updated.

<a href="#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20updated_at">Link to this property</a>

value: String

The TLS setting value. The type depends on the <code>setting_id</code> used in the request path:

- <code>ciphers</code>: an array of allowed cipher suite strings in BoringSSL format (e.g., <code>["ECDHE-RSA-AES128-GCM-SHA256", "AES128-GCM-SHA256"]</code>).
- <code>min_tls_version</code>: a string indicating the minimum TLS version — one of <code>"1.0"</code>, <code>"1.1"</code>, <code>"1.2"</code>, or <code>"1.3"</code> (e.g., <code>"1.2"</code>).
- <code>http2</code>: a string indicating whether HTTP/2 is enabled — <code>"on"</code> or <code>"off"</code> (e.g., <code>"on"</code>).

<a href="#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result%20%3E%20(attribute)%20value">Link to this property</a>

</details>

[Link to this property](<#(resource)%20hostnames.settings.tls%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result>)

### cloudflare\_hostname\_tls\_settings

Terraform

HTTPTypeScriptPythonGoTerraform

```
data "cloudflare_hostname_tls_settings" "example_hostname_tls_settings" {
  zone_id = "023e105f4ecef8ad9ca31a8372d0c353"
  setting_id = "ciphers"
}
```