cloudflare.getCustomHostnames

Cloudflare v6.16.0, May 19 26

Viewing docs for Cloudflare v6.16.0
published on Tuesday, May 19, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-cloudflare

Viewing docs for Cloudflare v6.16.0
published on Tuesday, May 19, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-cloudflare

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as cloudflare from "@pulumi/cloudflare";

const exampleCustomHostnames = cloudflare.getCustomHostnames({
    zoneId: "023e105f4ecef8ad9ca31a8372d0c353",
    id: "0d89c70d-ad9f-4843-b99f-6cc0252067e9",
    certificateAuthority: "google",
    customOriginServer: "origin2.example.com",
    direction: "desc",
    hostname: {
        contain: "example.com",
    },
    hostnameStatus: "provisioned",
    ssl: 0,
    sslStatus: "active",
    wildcard: false,
});

import pulumi
import pulumi_cloudflare as cloudflare

example_custom_hostnames = cloudflare.get_custom_hostnames(zone_id="023e105f4ecef8ad9ca31a8372d0c353",
    id="0d89c70d-ad9f-4843-b99f-6cc0252067e9",
    certificate_authority="google",
    custom_origin_server="origin2.example.com",
    direction="desc",
    hostname={
        "contain": "example.com",
    },
    hostname_status="provisioned",
    ssl=float(0),
    ssl_status="active",
    wildcard=False)

package main

import (
	"github.com/pulumi/pulumi-cloudflare/sdk/v6/go/cloudflare"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudflare.GetCustomHostnames(ctx, &cloudflare.LookupCustomHostnamesArgs{
			ZoneId:               pulumi.StringRef("023e105f4ecef8ad9ca31a8372d0c353"),
			Id:                   pulumi.StringRef("0d89c70d-ad9f-4843-b99f-6cc0252067e9"),
			CertificateAuthority: pulumi.StringRef("google"),
			CustomOriginServer:   pulumi.StringRef("origin2.example.com"),
			Direction:            pulumi.StringRef("desc"),
			Hostname: cloudflare.GetCustomHostnamesHostname{
				Contain: pulumi.StringRef("example.com"),
			},
			HostnameStatus: pulumi.StringRef("provisioned"),
			Ssl:            pulumi.Float64Ref(0),
			SslStatus:      pulumi.StringRef("active"),
			Wildcard:       pulumi.BoolRef(false),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Cloudflare = Pulumi.Cloudflare;

return await Deployment.RunAsync(() => 
{
    var exampleCustomHostnames = Cloudflare.GetCustomHostnames.Invoke(new()
    {
        ZoneId = "023e105f4ecef8ad9ca31a8372d0c353",
        Id = "0d89c70d-ad9f-4843-b99f-6cc0252067e9",
        CertificateAuthority = "google",
        CustomOriginServer = "origin2.example.com",
        Direction = "desc",
        Hostname = new Cloudflare.Inputs.GetCustomHostnamesHostnameInputArgs
        {
            Contain = "example.com",
        },
        HostnameStatus = "provisioned",
        Ssl = 0,
        SslStatus = "active",
        Wildcard = false,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.cloudflare.CloudflareFunctions;
import com.pulumi.cloudflare.inputs.GetCustomHostnamesArgs;
import com.pulumi.cloudflare.inputs.GetCustomHostnamesHostnameArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var exampleCustomHostnames = CloudflareFunctions.getCustomHostnames(GetCustomHostnamesArgs.builder()
            .zoneId("023e105f4ecef8ad9ca31a8372d0c353")
            .id("0d89c70d-ad9f-4843-b99f-6cc0252067e9")
            .certificateAuthority("google")
            .customOriginServer("origin2.example.com")
            .direction("desc")
            .hostname(GetCustomHostnamesHostnameArgs.builder()
                .contain("example.com")
                .build())
            .hostnameStatus("provisioned")
            .ssl(0.0)
            .sslStatus("active")
            .wildcard(false)
            .build());

    }
}

variables:
  exampleCustomHostnames:
    fn::invoke:
      function: cloudflare:getCustomHostnames
      arguments:
        zoneId: 023e105f4ecef8ad9ca31a8372d0c353
        id: 0d89c70d-ad9f-4843-b99f-6cc0252067e9
        certificateAuthority: google
        customOriginServer: origin2.example.com
        direction: desc
        hostname:
          contain: example.com
        hostnameStatus: provisioned
        ssl: 0
        sslStatus: active
        wildcard: false

Example coming soon!

Using getCustomHostnames

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getCustomHostnames(args: GetCustomHostnamesArgs, opts?: InvokeOptions): Promise<GetCustomHostnamesResult>
function getCustomHostnamesOutput(args: GetCustomHostnamesOutputArgs, opts?: InvokeOptions): Output<GetCustomHostnamesResult>

def get_custom_hostnames(certificate_authority: Optional[str] = None,
                         custom_origin_server: Optional[str] = None,
                         direction: Optional[str] = None,
                         hostname: Optional[GetCustomHostnamesHostname] = None,
                         hostname_status: Optional[str] = None,
                         id: Optional[str] = None,
                         max_items: Optional[int] = None,
                         order: Optional[str] = None,
                         ssl: Optional[float] = None,
                         ssl_status: Optional[str] = None,
                         wildcard: Optional[bool] = None,
                         zone_id: Optional[str] = None,
                         opts: Optional[InvokeOptions] = None) -> GetCustomHostnamesResult
def get_custom_hostnames_output(certificate_authority: pulumi.Input[Optional[str]] = None,
                         custom_origin_server: pulumi.Input[Optional[str]] = None,
                         direction: pulumi.Input[Optional[str]] = None,
                         hostname: pulumi.Input[Optional[GetCustomHostnamesHostnameArgs]] = None,
                         hostname_status: pulumi.Input[Optional[str]] = None,
                         id: pulumi.Input[Optional[str]] = None,
                         max_items: pulumi.Input[Optional[int]] = None,
                         order: pulumi.Input[Optional[str]] = None,
                         ssl: pulumi.Input[Optional[float]] = None,
                         ssl_status: pulumi.Input[Optional[str]] = None,
                         wildcard: pulumi.Input[Optional[bool]] = None,
                         zone_id: pulumi.Input[Optional[str]] = None,
                         opts: Optional[InvokeOptions] = None) -> Output[GetCustomHostnamesResult]

func LookupCustomHostnames(ctx *Context, args *LookupCustomHostnamesArgs, opts ...InvokeOption) (*LookupCustomHostnamesResult, error)
func LookupCustomHostnamesOutput(ctx *Context, args *LookupCustomHostnamesOutputArgs, opts ...InvokeOption) LookupCustomHostnamesResultOutput

> Note: This function is named LookupCustomHostnames in the Go SDK.

public static class GetCustomHostnames 
{
    public static Task<GetCustomHostnamesResult> InvokeAsync(GetCustomHostnamesArgs args, InvokeOptions? opts = null)
    public static Output<GetCustomHostnamesResult> Invoke(GetCustomHostnamesInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetCustomHostnamesResult> getCustomHostnames(GetCustomHostnamesArgs args, InvokeOptions options)
public static Output<GetCustomHostnamesResult> getCustomHostnames(GetCustomHostnamesArgs args, InvokeOptions options)

fn::invoke:
  function: cloudflare:index/getCustomHostnames:getCustomHostnames
  arguments:
    # arguments dictionary

data "cloudflare_getcustomhostnames" "name" {
    # arguments
}

The following arguments are supported:

CertificateAuthority string: Filter by the certificate authority that issued the SSL certificate. Available values: "google", "letsencrypt", "sslcom".
CustomOriginServer string: Filter by custom origin server name.
Direction string: Direction to order hostnames. Available values: "asc", "desc".
Hostname GetCustomHostnamesHostname
HostnameStatus string: Filter by the hostname's activation status. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
Id string: Hostname ID to match against. This ID was generated and returned during the initial customHostname creation. This parameter cannot be used with the 'hostname' parameter.
MaxItems int: Max items to fetch, default: 1000
Order string: Field to order hostnames by. Available values: "ssl", "sslStatus".
Ssl double: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.
SslStatus string: Filter by SSL certificate status. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
Wildcard bool: Filter by whether the custom hostname is a wildcard hostname.
ZoneId string: Identifier.

CertificateAuthority string: Filter by the certificate authority that issued the SSL certificate. Available values: "google", "letsencrypt", "sslcom".
CustomOriginServer string: Filter by custom origin server name.
Direction string: Direction to order hostnames. Available values: "asc", "desc".
Hostname GetCustomHostnamesHostname
HostnameStatus string: Filter by the hostname's activation status. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
Id string: Hostname ID to match against. This ID was generated and returned during the initial customHostname creation. This parameter cannot be used with the 'hostname' parameter.
MaxItems int: Max items to fetch, default: 1000
Order string: Field to order hostnames by. Available values: "ssl", "sslStatus".
Ssl float64: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.
SslStatus string: Filter by SSL certificate status. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
Wildcard bool: Filter by whether the custom hostname is a wildcard hostname.
ZoneId string: Identifier.

certificate_authority string: Filter by the certificate authority that issued the SSL certificate. Available values: "google", "letsencrypt", "sslcom".
custom_origin_server string: Filter by custom origin server name.
direction string: Direction to order hostnames. Available values: "asc", "desc".
hostname object
hostname_status string: Filter by the hostname's activation status. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
id string: Hostname ID to match against. This ID was generated and returned during the initial customHostname creation. This parameter cannot be used with the 'hostname' parameter.
max_items number: Max items to fetch, default: 1000
order string: Field to order hostnames by. Available values: "ssl", "sslStatus".
ssl number: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.
ssl_status string: Filter by SSL certificate status. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
wildcard bool: Filter by whether the custom hostname is a wildcard hostname.
zone_id string: Identifier.

certificateAuthority String: Filter by the certificate authority that issued the SSL certificate. Available values: "google", "letsencrypt", "sslcom".
customOriginServer String: Filter by custom origin server name.
direction String: Direction to order hostnames. Available values: "asc", "desc".
hostname GetCustomHostnamesHostname
hostnameStatus String: Filter by the hostname's activation status. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
id String: Hostname ID to match against. This ID was generated and returned during the initial customHostname creation. This parameter cannot be used with the 'hostname' parameter.
maxItems Integer: Max items to fetch, default: 1000
order String: Field to order hostnames by. Available values: "ssl", "sslStatus".
ssl Double: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.
sslStatus String: Filter by SSL certificate status. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
wildcard Boolean: Filter by whether the custom hostname is a wildcard hostname.
zoneId String: Identifier.

certificateAuthority string: Filter by the certificate authority that issued the SSL certificate. Available values: "google", "letsencrypt", "sslcom".
customOriginServer string: Filter by custom origin server name.
direction string: Direction to order hostnames. Available values: "asc", "desc".
hostname GetCustomHostnamesHostname
hostnameStatus string: Filter by the hostname's activation status. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
id string: Hostname ID to match against. This ID was generated and returned during the initial customHostname creation. This parameter cannot be used with the 'hostname' parameter.
maxItems number: Max items to fetch, default: 1000
order string: Field to order hostnames by. Available values: "ssl", "sslStatus".
ssl number: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.
sslStatus string: Filter by SSL certificate status. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
wildcard boolean: Filter by whether the custom hostname is a wildcard hostname.
zoneId string: Identifier.

certificate_authority str: Filter by the certificate authority that issued the SSL certificate. Available values: "google", "letsencrypt", "sslcom".
custom_origin_server str: Filter by custom origin server name.
direction str: Direction to order hostnames. Available values: "asc", "desc".
hostname GetCustomHostnamesHostname
hostname_status str: Filter by the hostname's activation status. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
id str: Hostname ID to match against. This ID was generated and returned during the initial customHostname creation. This parameter cannot be used with the 'hostname' parameter.
max_items int: Max items to fetch, default: 1000
order str: Field to order hostnames by. Available values: "ssl", "sslStatus".
ssl float: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.
ssl_status str: Filter by SSL certificate status. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
wildcard bool: Filter by whether the custom hostname is a wildcard hostname.
zone_id str: Identifier.

certificateAuthority String: Filter by the certificate authority that issued the SSL certificate. Available values: "google", "letsencrypt", "sslcom".
customOriginServer String: Filter by custom origin server name.
direction String: Direction to order hostnames. Available values: "asc", "desc".
hostname Property Map
hostnameStatus String: Filter by the hostname's activation status. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
id String: Hostname ID to match against. This ID was generated and returned during the initial customHostname creation. This parameter cannot be used with the 'hostname' parameter.
maxItems Number: Max items to fetch, default: 1000
order String: Field to order hostnames by. Available values: "ssl", "sslStatus".
ssl Number: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.
sslStatus String: Filter by SSL certificate status. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
wildcard Boolean: Filter by whether the custom hostname is a wildcard hostname.
zoneId String: Identifier.

getCustomHostnames Result

The following output properties are available:

Order string: Field to order hostnames by. Available values: "ssl", "sslStatus".
Results List<GetCustomHostnamesResult>: The items returned by the data source
CertificateAuthority string: Filter by the certificate authority that issued the SSL certificate. Available values: "google", "letsencrypt", "sslcom".
CustomOriginServer string: Filter by custom origin server name.
Direction string: Direction to order hostnames. Available values: "asc", "desc".
Hostname GetCustomHostnamesHostname
HostnameStatus string: Filter by the hostname's activation status. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
Id string: Hostname ID to match against. This ID was generated and returned during the initial customHostname creation. This parameter cannot be used with the 'hostname' parameter.
MaxItems int: Max items to fetch, default: 1000
Ssl double: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.
SslStatus string: Filter by SSL certificate status. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
Wildcard bool: Filter by whether the custom hostname is a wildcard hostname.
ZoneId string: Identifier.

Order string: Field to order hostnames by. Available values: "ssl", "sslStatus".
Results []GetCustomHostnamesResult: The items returned by the data source
CertificateAuthority string: Filter by the certificate authority that issued the SSL certificate. Available values: "google", "letsencrypt", "sslcom".
CustomOriginServer string: Filter by custom origin server name.
Direction string: Direction to order hostnames. Available values: "asc", "desc".
Hostname GetCustomHostnamesHostname
HostnameStatus string: Filter by the hostname's activation status. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
Id string: Hostname ID to match against. This ID was generated and returned during the initial customHostname creation. This parameter cannot be used with the 'hostname' parameter.
MaxItems int: Max items to fetch, default: 1000
Ssl float64: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.
SslStatus string: Filter by SSL certificate status. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
Wildcard bool: Filter by whether the custom hostname is a wildcard hostname.
ZoneId string: Identifier.

order string: Field to order hostnames by. Available values: "ssl", "sslStatus".
results list(object): The items returned by the data source
certificate_authority string: Filter by the certificate authority that issued the SSL certificate. Available values: "google", "letsencrypt", "sslcom".
custom_origin_server string: Filter by custom origin server name.
direction string: Direction to order hostnames. Available values: "asc", "desc".
hostname object
hostname_status string: Filter by the hostname's activation status. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
id string: Hostname ID to match against. This ID was generated and returned during the initial customHostname creation. This parameter cannot be used with the 'hostname' parameter.
max_items number: Max items to fetch, default: 1000
ssl number: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.
ssl_status string: Filter by SSL certificate status. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
wildcard bool: Filter by whether the custom hostname is a wildcard hostname.
zone_id string: Identifier.

order String: Field to order hostnames by. Available values: "ssl", "sslStatus".
results List<GetCustomHostnamesResult>: The items returned by the data source
certificateAuthority String: Filter by the certificate authority that issued the SSL certificate. Available values: "google", "letsencrypt", "sslcom".
customOriginServer String: Filter by custom origin server name.
direction String: Direction to order hostnames. Available values: "asc", "desc".
hostname GetCustomHostnamesHostname
hostnameStatus String: Filter by the hostname's activation status. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
id String: Hostname ID to match against. This ID was generated and returned during the initial customHostname creation. This parameter cannot be used with the 'hostname' parameter.
maxItems Integer: Max items to fetch, default: 1000
ssl Double: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.
sslStatus String: Filter by SSL certificate status. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
wildcard Boolean: Filter by whether the custom hostname is a wildcard hostname.
zoneId String: Identifier.

order string: Field to order hostnames by. Available values: "ssl", "sslStatus".
results GetCustomHostnamesResult[]: The items returned by the data source
certificateAuthority string: Filter by the certificate authority that issued the SSL certificate. Available values: "google", "letsencrypt", "sslcom".
customOriginServer string: Filter by custom origin server name.
direction string: Direction to order hostnames. Available values: "asc", "desc".
hostname GetCustomHostnamesHostname
hostnameStatus string: Filter by the hostname's activation status. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
id string: Hostname ID to match against. This ID was generated and returned during the initial customHostname creation. This parameter cannot be used with the 'hostname' parameter.
maxItems number: Max items to fetch, default: 1000
ssl number: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.
sslStatus string: Filter by SSL certificate status. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
wildcard boolean: Filter by whether the custom hostname is a wildcard hostname.
zoneId string: Identifier.

order str: Field to order hostnames by. Available values: "ssl", "sslStatus".
results Sequence[GetCustomHostnamesResult]: The items returned by the data source
certificate_authority str: Filter by the certificate authority that issued the SSL certificate. Available values: "google", "letsencrypt", "sslcom".
custom_origin_server str: Filter by custom origin server name.
direction str: Direction to order hostnames. Available values: "asc", "desc".
hostname GetCustomHostnamesHostname
hostname_status str: Filter by the hostname's activation status. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
id str: Hostname ID to match against. This ID was generated and returned during the initial customHostname creation. This parameter cannot be used with the 'hostname' parameter.
max_items int: Max items to fetch, default: 1000
ssl float: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.
ssl_status str: Filter by SSL certificate status. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
wildcard bool: Filter by whether the custom hostname is a wildcard hostname.
zone_id str: Identifier.

order String: Field to order hostnames by. Available values: "ssl", "sslStatus".
results List<Property Map>: The items returned by the data source
certificateAuthority String: Filter by the certificate authority that issued the SSL certificate. Available values: "google", "letsencrypt", "sslcom".
customOriginServer String: Filter by custom origin server name.
direction String: Direction to order hostnames. Available values: "asc", "desc".
hostname Property Map
hostnameStatus String: Filter by the hostname's activation status. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
id String: Hostname ID to match against. This ID was generated and returned during the initial customHostname creation. This parameter cannot be used with the 'hostname' parameter.
maxItems Number: Max items to fetch, default: 1000
ssl Number: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.
sslStatus String: Filter by SSL certificate status. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
wildcard Boolean: Filter by whether the custom hostname is a wildcard hostname.
zoneId String: Identifier.

Supporting Types

GetCustomHostnamesHostname

Contain string: Filters hostnames by a substring match on the hostname value. This parameter cannot be used with the 'id' parameter.

Contain string: Filters hostnames by a substring match on the hostname value. This parameter cannot be used with the 'id' parameter.

contain string: Filters hostnames by a substring match on the hostname value. This parameter cannot be used with the 'id' parameter.

contain String: Filters hostnames by a substring match on the hostname value. This parameter cannot be used with the 'id' parameter.

contain string: Filters hostnames by a substring match on the hostname value. This parameter cannot be used with the 'id' parameter.

contain str: Filters hostnames by a substring match on the hostname value. This parameter cannot be used with the 'id' parameter.

contain String: Filters hostnames by a substring match on the hostname value. This parameter cannot be used with the 'id' parameter.

GetCustomHostnamesResult

CreatedAt string: This is the time the hostname was created.
CustomMetadata Dictionary<string, string>: Unique key/value metadata for this hostname. These are per-hostname (customer) settings.
CustomOriginServer string: a valid hostname that’s been added to your DNS zone as an A, AAAA, or CNAME record.
CustomOriginSni string: A hostname that will be sent to your custom origin server as SNI for TLS handshake. This can be a valid subdomain of the zone or custom origin server name or the string ':requesthostheader:' which will cause the host header in the request to be used as SNI. Not configurable with default/fallback origin server.
Hostname string: The custom hostname that will point to your hostname via CNAME.
Id string: Identifier.
OwnershipVerification GetCustomHostnamesResultOwnershipVerification: This is a record which can be placed to activate a hostname.
OwnershipVerificationHttp GetCustomHostnamesResultOwnershipVerificationHttp: This presents the token to be served by the given http url to activate a hostname.
Ssl GetCustomHostnamesResultSsl
Status string: Status of the hostname's activation. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
VerificationErrors List<string>: These are errors that were encountered while trying to activate a hostname.

CreatedAt string: This is the time the hostname was created.
CustomMetadata map[string]string: Unique key/value metadata for this hostname. These are per-hostname (customer) settings.
CustomOriginServer string: a valid hostname that’s been added to your DNS zone as an A, AAAA, or CNAME record.
CustomOriginSni string: A hostname that will be sent to your custom origin server as SNI for TLS handshake. This can be a valid subdomain of the zone or custom origin server name or the string ':requesthostheader:' which will cause the host header in the request to be used as SNI. Not configurable with default/fallback origin server.
Hostname string: The custom hostname that will point to your hostname via CNAME.
Id string: Identifier.
OwnershipVerification GetCustomHostnamesResultOwnershipVerification: This is a record which can be placed to activate a hostname.
OwnershipVerificationHttp GetCustomHostnamesResultOwnershipVerificationHttp: This presents the token to be served by the given http url to activate a hostname.
Ssl GetCustomHostnamesResultSsl
Status string: Status of the hostname's activation. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
VerificationErrors []string: These are errors that were encountered while trying to activate a hostname.

created_at string: This is the time the hostname was created.
custom_metadata map(string): Unique key/value metadata for this hostname. These are per-hostname (customer) settings.
custom_origin_server string: a valid hostname that’s been added to your DNS zone as an A, AAAA, or CNAME record.
custom_origin_sni string: A hostname that will be sent to your custom origin server as SNI for TLS handshake. This can be a valid subdomain of the zone or custom origin server name or the string ':requesthostheader:' which will cause the host header in the request to be used as SNI. Not configurable with default/fallback origin server.
hostname string: The custom hostname that will point to your hostname via CNAME.
id string: Identifier.
ownership_verification object: This is a record which can be placed to activate a hostname.
ownership_verification_http object: This presents the token to be served by the given http url to activate a hostname.
ssl object
status string: Status of the hostname's activation. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
verification_errors list(string): These are errors that were encountered while trying to activate a hostname.

createdAt String: This is the time the hostname was created.
customMetadata Map<String,String>: Unique key/value metadata for this hostname. These are per-hostname (customer) settings.
customOriginServer String: a valid hostname that’s been added to your DNS zone as an A, AAAA, or CNAME record.
customOriginSni String: A hostname that will be sent to your custom origin server as SNI for TLS handshake. This can be a valid subdomain of the zone or custom origin server name or the string ':requesthostheader:' which will cause the host header in the request to be used as SNI. Not configurable with default/fallback origin server.
hostname String: The custom hostname that will point to your hostname via CNAME.
id String: Identifier.
ownershipVerification GetCustomHostnamesResultOwnershipVerification: This is a record which can be placed to activate a hostname.
ownershipVerificationHttp GetCustomHostnamesResultOwnershipVerificationHttp: This presents the token to be served by the given http url to activate a hostname.
ssl GetCustomHostnamesResultSsl
status String: Status of the hostname's activation. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
verificationErrors List<String>: These are errors that were encountered while trying to activate a hostname.

createdAt string: This is the time the hostname was created.
customMetadata {[key: string]: string}: Unique key/value metadata for this hostname. These are per-hostname (customer) settings.
customOriginServer string: a valid hostname that’s been added to your DNS zone as an A, AAAA, or CNAME record.
customOriginSni string: A hostname that will be sent to your custom origin server as SNI for TLS handshake. This can be a valid subdomain of the zone or custom origin server name or the string ':requesthostheader:' which will cause the host header in the request to be used as SNI. Not configurable with default/fallback origin server.
hostname string: The custom hostname that will point to your hostname via CNAME.
id string: Identifier.
ownershipVerification GetCustomHostnamesResultOwnershipVerification: This is a record which can be placed to activate a hostname.
ownershipVerificationHttp GetCustomHostnamesResultOwnershipVerificationHttp: This presents the token to be served by the given http url to activate a hostname.
ssl GetCustomHostnamesResultSsl
status string: Status of the hostname's activation. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
verificationErrors string[]: These are errors that were encountered while trying to activate a hostname.

created_at str: This is the time the hostname was created.
custom_metadata Mapping[str, str]: Unique key/value metadata for this hostname. These are per-hostname (customer) settings.
custom_origin_server str: a valid hostname that’s been added to your DNS zone as an A, AAAA, or CNAME record.
custom_origin_sni str: A hostname that will be sent to your custom origin server as SNI for TLS handshake. This can be a valid subdomain of the zone or custom origin server name or the string ':requesthostheader:' which will cause the host header in the request to be used as SNI. Not configurable with default/fallback origin server.
hostname str: The custom hostname that will point to your hostname via CNAME.
id str: Identifier.
ownership_verification GetCustomHostnamesResultOwnershipVerification: This is a record which can be placed to activate a hostname.
ownership_verification_http GetCustomHostnamesResultOwnershipVerificationHttp: This presents the token to be served by the given http url to activate a hostname.
ssl GetCustomHostnamesResultSsl
status str: Status of the hostname's activation. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
verification_errors Sequence[str]: These are errors that were encountered while trying to activate a hostname.

createdAt String: This is the time the hostname was created.
customMetadata Map<String>: Unique key/value metadata for this hostname. These are per-hostname (customer) settings.
customOriginServer String: a valid hostname that’s been added to your DNS zone as an A, AAAA, or CNAME record.
customOriginSni String: A hostname that will be sent to your custom origin server as SNI for TLS handshake. This can be a valid subdomain of the zone or custom origin server name or the string ':requesthostheader:' which will cause the host header in the request to be used as SNI. Not configurable with default/fallback origin server.
hostname String: The custom hostname that will point to your hostname via CNAME.
id String: Identifier.
ownershipVerification Property Map: This is a record which can be placed to activate a hostname.
ownershipVerificationHttp Property Map: This presents the token to be served by the given http url to activate a hostname.
ssl Property Map
status String: Status of the hostname's activation. Available values: "active", "pending", "activeredeploying", "moved", "pendingdeletion", "deleted", "pendingblocked", "pendingmigration", "pendingprovisioned", "testpending", "testactive", "testactiveapex", "testblocked", "testFailed", "provisioned", "blocked".
verificationErrors List<String>: These are errors that were encountered while trying to activate a hostname.

GetCustomHostnamesResultOwnershipVerification

Name string: DNS Name for record.
Type string: DNS Record type. Available values: "txt".
Value string: Content for the record.

Name string: DNS Name for record.
Type string: DNS Record type. Available values: "txt".
Value string: Content for the record.

name string: DNS Name for record.
type string: DNS Record type. Available values: "txt".
value string: Content for the record.

name String: DNS Name for record.
type String: DNS Record type. Available values: "txt".
value String: Content for the record.

name string: DNS Name for record.
type string: DNS Record type. Available values: "txt".
value string: Content for the record.

name str: DNS Name for record.
type str: DNS Record type. Available values: "txt".
value str: Content for the record.

name String: DNS Name for record.
type String: DNS Record type. Available values: "txt".
value String: Content for the record.

GetCustomHostnamesResultOwnershipVerificationHttp

HttpBody string: Token to be served.
HttpUrl string: The HTTP URL that will be checked during custom hostname verification and where the customer should host the token.

HttpBody string: Token to be served.
HttpUrl string: The HTTP URL that will be checked during custom hostname verification and where the customer should host the token.

http_body string: Token to be served.
http_url string: The HTTP URL that will be checked during custom hostname verification and where the customer should host the token.

httpBody String: Token to be served.
httpUrl String: The HTTP URL that will be checked during custom hostname verification and where the customer should host the token.

httpBody string: Token to be served.
httpUrl string: The HTTP URL that will be checked during custom hostname verification and where the customer should host the token.

http_body str: Token to be served.
http_url str: The HTTP URL that will be checked during custom hostname verification and where the customer should host the token.

httpBody String: Token to be served.
httpUrl String: The HTTP URL that will be checked during custom hostname verification and where the customer should host the token.

GetCustomHostnamesResultSsl

BundleMethod string: A ubiquitous bundle has the highest probability of being verified everywhere, even by clients using outdated or unusual trust stores. An optimal bundle uses the shortest chain and newest intermediates. And the force bundle verifies the chain, but does not otherwise modify it. Available values: "ubiquitous", "optimal", "force".
CertificateAuthority string: The Certificate Authority that will issue the certificate Available values: "digicert", "google", "letsencrypt", "sslcom".
CustomCertificate string: If a custom uploaded certificate is used.
CustomCsrId string: The identifier for the Custom CSR that was used.
CustomKey string: The key for a custom uploaded certificate.
DcvDelegationRecords List<GetCustomHostnamesResultSslDcvDelegationRecord>: DCV Delegation records for domain validation.
ExpiresOn string: The time the custom certificate expires on.
Hosts List<string>: A list of Hostnames on a custom uploaded certificate.
Id string: Custom hostname SSL identifier tag.
Issuer string: The issuer on a custom uploaded certificate.
Method string: Domain control validation (DCV) method used for this hostname. Available values: "http", "txt", "email".
SerialNumber string: The serial number on a custom uploaded certificate.
Settings GetCustomHostnamesResultSslSettings
Signature string: The signature on a custom uploaded certificate.
Status string: Status of the hostname's SSL certificates. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
Type string: Level of validation to be used for this hostname. Domain validation (dv) must be used. Available values: "dv".
UploadedOn string: The time the custom certificate was uploaded.
ValidationErrors List<GetCustomHostnamesResultSslValidationError>: Domain validation errors that have been received by the certificate authority (CA).
ValidationRecords List<GetCustomHostnamesResultSslValidationRecord>
Wildcard bool: Indicates whether the certificate covers a wildcard.

BundleMethod string: A ubiquitous bundle has the highest probability of being verified everywhere, even by clients using outdated or unusual trust stores. An optimal bundle uses the shortest chain and newest intermediates. And the force bundle verifies the chain, but does not otherwise modify it. Available values: "ubiquitous", "optimal", "force".
CertificateAuthority string: The Certificate Authority that will issue the certificate Available values: "digicert", "google", "letsencrypt", "sslcom".
CustomCertificate string: If a custom uploaded certificate is used.
CustomCsrId string: The identifier for the Custom CSR that was used.
CustomKey string: The key for a custom uploaded certificate.
DcvDelegationRecords []GetCustomHostnamesResultSslDcvDelegationRecord: DCV Delegation records for domain validation.
ExpiresOn string: The time the custom certificate expires on.
Hosts []string: A list of Hostnames on a custom uploaded certificate.
Id string: Custom hostname SSL identifier tag.
Issuer string: The issuer on a custom uploaded certificate.
Method string: Domain control validation (DCV) method used for this hostname. Available values: "http", "txt", "email".
SerialNumber string: The serial number on a custom uploaded certificate.
Settings GetCustomHostnamesResultSslSettings
Signature string: The signature on a custom uploaded certificate.
Status string: Status of the hostname's SSL certificates. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
Type string: Level of validation to be used for this hostname. Domain validation (dv) must be used. Available values: "dv".
UploadedOn string: The time the custom certificate was uploaded.
ValidationErrors []GetCustomHostnamesResultSslValidationError: Domain validation errors that have been received by the certificate authority (CA).
ValidationRecords []GetCustomHostnamesResultSslValidationRecord
Wildcard bool: Indicates whether the certificate covers a wildcard.

bundle_method string: A ubiquitous bundle has the highest probability of being verified everywhere, even by clients using outdated or unusual trust stores. An optimal bundle uses the shortest chain and newest intermediates. And the force bundle verifies the chain, but does not otherwise modify it. Available values: "ubiquitous", "optimal", "force".
certificate_authority string: The Certificate Authority that will issue the certificate Available values: "digicert", "google", "letsencrypt", "sslcom".
custom_certificate string: If a custom uploaded certificate is used.
custom_csr_id string: The identifier for the Custom CSR that was used.
custom_key string: The key for a custom uploaded certificate.
dcv_delegation_records list(object): DCV Delegation records for domain validation.
expires_on string: The time the custom certificate expires on.
hosts list(string): A list of Hostnames on a custom uploaded certificate.
id string: Custom hostname SSL identifier tag.
issuer string: The issuer on a custom uploaded certificate.
method string: Domain control validation (DCV) method used for this hostname. Available values: "http", "txt", "email".
serial_number string: The serial number on a custom uploaded certificate.
settings object
signature string: The signature on a custom uploaded certificate.
status string: Status of the hostname's SSL certificates. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
type string: Level of validation to be used for this hostname. Domain validation (dv) must be used. Available values: "dv".
uploaded_on string: The time the custom certificate was uploaded.
validation_errors list(object): Domain validation errors that have been received by the certificate authority (CA).
validation_records list(object)
wildcard bool: Indicates whether the certificate covers a wildcard.

bundleMethod String: A ubiquitous bundle has the highest probability of being verified everywhere, even by clients using outdated or unusual trust stores. An optimal bundle uses the shortest chain and newest intermediates. And the force bundle verifies the chain, but does not otherwise modify it. Available values: "ubiquitous", "optimal", "force".
certificateAuthority String: The Certificate Authority that will issue the certificate Available values: "digicert", "google", "letsencrypt", "sslcom".
customCertificate String: If a custom uploaded certificate is used.
customCsrId String: The identifier for the Custom CSR that was used.
customKey String: The key for a custom uploaded certificate.
dcvDelegationRecords List<GetCustomHostnamesResultSslDcvDelegationRecord>: DCV Delegation records for domain validation.
expiresOn String: The time the custom certificate expires on.
hosts List<String>: A list of Hostnames on a custom uploaded certificate.
id String: Custom hostname SSL identifier tag.
issuer String: The issuer on a custom uploaded certificate.
method String: Domain control validation (DCV) method used for this hostname. Available values: "http", "txt", "email".
serialNumber String: The serial number on a custom uploaded certificate.
settings GetCustomHostnamesResultSslSettings
signature String: The signature on a custom uploaded certificate.
status String: Status of the hostname's SSL certificates. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
type String: Level of validation to be used for this hostname. Domain validation (dv) must be used. Available values: "dv".
uploadedOn String: The time the custom certificate was uploaded.
validationErrors List<GetCustomHostnamesResultSslValidationError>: Domain validation errors that have been received by the certificate authority (CA).
validationRecords List<GetCustomHostnamesResultSslValidationRecord>
wildcard Boolean: Indicates whether the certificate covers a wildcard.

bundleMethod string: A ubiquitous bundle has the highest probability of being verified everywhere, even by clients using outdated or unusual trust stores. An optimal bundle uses the shortest chain and newest intermediates. And the force bundle verifies the chain, but does not otherwise modify it. Available values: "ubiquitous", "optimal", "force".
certificateAuthority string: The Certificate Authority that will issue the certificate Available values: "digicert", "google", "letsencrypt", "sslcom".
customCertificate string: If a custom uploaded certificate is used.
customCsrId string: The identifier for the Custom CSR that was used.
customKey string: The key for a custom uploaded certificate.
dcvDelegationRecords GetCustomHostnamesResultSslDcvDelegationRecord[]: DCV Delegation records for domain validation.
expiresOn string: The time the custom certificate expires on.
hosts string[]: A list of Hostnames on a custom uploaded certificate.
id string: Custom hostname SSL identifier tag.
issuer string: The issuer on a custom uploaded certificate.
method string: Domain control validation (DCV) method used for this hostname. Available values: "http", "txt", "email".
serialNumber string: The serial number on a custom uploaded certificate.
settings GetCustomHostnamesResultSslSettings
signature string: The signature on a custom uploaded certificate.
status string: Status of the hostname's SSL certificates. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
type string: Level of validation to be used for this hostname. Domain validation (dv) must be used. Available values: "dv".
uploadedOn string: The time the custom certificate was uploaded.
validationErrors GetCustomHostnamesResultSslValidationError[]: Domain validation errors that have been received by the certificate authority (CA).
validationRecords GetCustomHostnamesResultSslValidationRecord[]
wildcard boolean: Indicates whether the certificate covers a wildcard.

bundle_method str: A ubiquitous bundle has the highest probability of being verified everywhere, even by clients using outdated or unusual trust stores. An optimal bundle uses the shortest chain and newest intermediates. And the force bundle verifies the chain, but does not otherwise modify it. Available values: "ubiquitous", "optimal", "force".
certificate_authority str: The Certificate Authority that will issue the certificate Available values: "digicert", "google", "letsencrypt", "sslcom".
custom_certificate str: If a custom uploaded certificate is used.
custom_csr_id str: The identifier for the Custom CSR that was used.
custom_key str: The key for a custom uploaded certificate.
dcv_delegation_records Sequence[GetCustomHostnamesResultSslDcvDelegationRecord]: DCV Delegation records for domain validation.
expires_on str: The time the custom certificate expires on.
hosts Sequence[str]: A list of Hostnames on a custom uploaded certificate.
id str: Custom hostname SSL identifier tag.
issuer str: The issuer on a custom uploaded certificate.
method str: Domain control validation (DCV) method used for this hostname. Available values: "http", "txt", "email".
serial_number str: The serial number on a custom uploaded certificate.
settings GetCustomHostnamesResultSslSettings
signature str: The signature on a custom uploaded certificate.
status str: Status of the hostname's SSL certificates. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
type str: Level of validation to be used for this hostname. Domain validation (dv) must be used. Available values: "dv".
uploaded_on str: The time the custom certificate was uploaded.
validation_errors Sequence[GetCustomHostnamesResultSslValidationError]: Domain validation errors that have been received by the certificate authority (CA).
validation_records Sequence[GetCustomHostnamesResultSslValidationRecord]
wildcard bool: Indicates whether the certificate covers a wildcard.

bundleMethod String: A ubiquitous bundle has the highest probability of being verified everywhere, even by clients using outdated or unusual trust stores. An optimal bundle uses the shortest chain and newest intermediates. And the force bundle verifies the chain, but does not otherwise modify it. Available values: "ubiquitous", "optimal", "force".
certificateAuthority String: The Certificate Authority that will issue the certificate Available values: "digicert", "google", "letsencrypt", "sslcom".
customCertificate String: If a custom uploaded certificate is used.
customCsrId String: The identifier for the Custom CSR that was used.
customKey String: The key for a custom uploaded certificate.
dcvDelegationRecords List<Property Map>: DCV Delegation records for domain validation.
expiresOn String: The time the custom certificate expires on.
hosts List<String>: A list of Hostnames on a custom uploaded certificate.
id String: Custom hostname SSL identifier tag.
issuer String: The issuer on a custom uploaded certificate.
method String: Domain control validation (DCV) method used for this hostname. Available values: "http", "txt", "email".
serialNumber String: The serial number on a custom uploaded certificate.
settings Property Map
signature String: The signature on a custom uploaded certificate.
status String: Status of the hostname's SSL certificates. Available values: "initializing", "pendingvalidation", "deleted", "pendingissuance", "pendingdeployment", "pendingdeletion", "pendingexpiration", "expired", "active", "initializingtimedout", "validationtimedout", "issuancetimedout", "deploymenttimedout", "deletiontimedout", "pendingcleanup", "stagingdeployment", "stagingactive", "deactivating", "inactive", "backupissued", "holdingdeployment".
type String: Level of validation to be used for this hostname. Domain validation (dv) must be used. Available values: "dv".
uploadedOn String: The time the custom certificate was uploaded.
validationErrors List<Property Map>: Domain validation errors that have been received by the certificate authority (CA).
validationRecords List<Property Map>
wildcard Boolean: Indicates whether the certificate covers a wildcard.

GetCustomHostnamesResultSslDcvDelegationRecord

Cname string: The CNAME record hostname for DCV delegation.
CnameTarget string: The CNAME record target value for DCV delegation.
Emails List<string>: The set of email addresses that the certificate authority (CA) will use to complete domain validation.
HttpBody string: The content that the certificate authority (CA) will expect to find at the httpUrl during the domain validation.
HttpUrl string: The url that will be checked during domain validation.
Status string: Status of the validation record.
TxtName string: The hostname that the certificate authority (CA) will check for a TXT record during domain validation .
TxtValue string: The TXT record that the certificate authority (CA) will check during domain validation.

Cname string: The CNAME record hostname for DCV delegation.
CnameTarget string: The CNAME record target value for DCV delegation.
Emails []string: The set of email addresses that the certificate authority (CA) will use to complete domain validation.
HttpBody string: The content that the certificate authority (CA) will expect to find at the httpUrl during the domain validation.
HttpUrl string: The url that will be checked during domain validation.
Status string: Status of the validation record.
TxtName string: The hostname that the certificate authority (CA) will check for a TXT record during domain validation .
TxtValue string: The TXT record that the certificate authority (CA) will check during domain validation.

cname string: The CNAME record hostname for DCV delegation.
cname_target string: The CNAME record target value for DCV delegation.
emails list(string): The set of email addresses that the certificate authority (CA) will use to complete domain validation.
http_body string: The content that the certificate authority (CA) will expect to find at the httpUrl during the domain validation.
http_url string: The url that will be checked during domain validation.
status string: Status of the validation record.
txt_name string: The hostname that the certificate authority (CA) will check for a TXT record during domain validation .
txt_value string: The TXT record that the certificate authority (CA) will check during domain validation.

cname String: The CNAME record hostname for DCV delegation.
cnameTarget String: The CNAME record target value for DCV delegation.
emails List<String>: The set of email addresses that the certificate authority (CA) will use to complete domain validation.
httpBody String: The content that the certificate authority (CA) will expect to find at the httpUrl during the domain validation.
httpUrl String: The url that will be checked during domain validation.
status String: Status of the validation record.
txtName String: The hostname that the certificate authority (CA) will check for a TXT record during domain validation .
txtValue String: The TXT record that the certificate authority (CA) will check during domain validation.

cname string: The CNAME record hostname for DCV delegation.
cnameTarget string: The CNAME record target value for DCV delegation.
emails string[]: The set of email addresses that the certificate authority (CA) will use to complete domain validation.
httpBody string: The content that the certificate authority (CA) will expect to find at the httpUrl during the domain validation.
httpUrl string: The url that will be checked during domain validation.
status string: Status of the validation record.
txtName string: The hostname that the certificate authority (CA) will check for a TXT record during domain validation .
txtValue string: The TXT record that the certificate authority (CA) will check during domain validation.

cname str: The CNAME record hostname for DCV delegation.
cname_target str: The CNAME record target value for DCV delegation.
emails Sequence[str]: The set of email addresses that the certificate authority (CA) will use to complete domain validation.
http_body str: The content that the certificate authority (CA) will expect to find at the httpUrl during the domain validation.
http_url str: The url that will be checked during domain validation.
status str: Status of the validation record.
txt_name str: The hostname that the certificate authority (CA) will check for a TXT record during domain validation .
txt_value str: The TXT record that the certificate authority (CA) will check during domain validation.

cname String: The CNAME record hostname for DCV delegation.
cnameTarget String: The CNAME record target value for DCV delegation.
emails List<String>: The set of email addresses that the certificate authority (CA) will use to complete domain validation.
httpBody String: The content that the certificate authority (CA) will expect to find at the httpUrl during the domain validation.
httpUrl String: The url that will be checked during domain validation.
status String: Status of the validation record.
txtName String: The hostname that the certificate authority (CA) will check for a TXT record during domain validation .
txtValue String: The TXT record that the certificate authority (CA) will check during domain validation.

GetCustomHostnamesResultSslSettings

Ciphers List<string>: An allowlist of ciphers for TLS termination. These ciphers must be in the BoringSSL format.
EarlyHints string: Whether or not Early Hints is enabled. Available values: "on", "off".
Http2 string: Whether or not HTTP2 is enabled. Available values: "on", "off".
MinTlsVersion string: The minimum TLS version supported. Available values: "1.0", "1.1", "1.2", "1.3".
Tls13 string: Whether or not TLS 1.3 is enabled. Available values: "on", "off".

Ciphers []string: An allowlist of ciphers for TLS termination. These ciphers must be in the BoringSSL format.
EarlyHints string: Whether or not Early Hints is enabled. Available values: "on", "off".
Http2 string: Whether or not HTTP2 is enabled. Available values: "on", "off".
MinTlsVersion string: The minimum TLS version supported. Available values: "1.0", "1.1", "1.2", "1.3".
Tls13 string: Whether or not TLS 1.3 is enabled. Available values: "on", "off".

ciphers list(string): An allowlist of ciphers for TLS termination. These ciphers must be in the BoringSSL format.
early_hints string: Whether or not Early Hints is enabled. Available values: "on", "off".
http2 string: Whether or not HTTP2 is enabled. Available values: "on", "off".
min_tls_version string: The minimum TLS version supported. Available values: "1.0", "1.1", "1.2", "1.3".
tls13 string: Whether or not TLS 1.3 is enabled. Available values: "on", "off".

ciphers List<String>: An allowlist of ciphers for TLS termination. These ciphers must be in the BoringSSL format.
earlyHints String: Whether or not Early Hints is enabled. Available values: "on", "off".
http2 String: Whether or not HTTP2 is enabled. Available values: "on", "off".
minTlsVersion String: The minimum TLS version supported. Available values: "1.0", "1.1", "1.2", "1.3".
tls13 String: Whether or not TLS 1.3 is enabled. Available values: "on", "off".

ciphers string[]: An allowlist of ciphers for TLS termination. These ciphers must be in the BoringSSL format.
earlyHints string: Whether or not Early Hints is enabled. Available values: "on", "off".
http2 string: Whether or not HTTP2 is enabled. Available values: "on", "off".
minTlsVersion string: The minimum TLS version supported. Available values: "1.0", "1.1", "1.2", "1.3".
tls13 string: Whether or not TLS 1.3 is enabled. Available values: "on", "off".

ciphers Sequence[str]: An allowlist of ciphers for TLS termination. These ciphers must be in the BoringSSL format.
early_hints str: Whether or not Early Hints is enabled. Available values: "on", "off".
http2 str: Whether or not HTTP2 is enabled. Available values: "on", "off".
min_tls_version str: The minimum TLS version supported. Available values: "1.0", "1.1", "1.2", "1.3".
tls13 str: Whether or not TLS 1.3 is enabled. Available values: "on", "off".

ciphers List<String>: An allowlist of ciphers for TLS termination. These ciphers must be in the BoringSSL format.
earlyHints String: Whether or not Early Hints is enabled. Available values: "on", "off".
http2 String: Whether or not HTTP2 is enabled. Available values: "on", "off".
minTlsVersion String: The minimum TLS version supported. Available values: "1.0", "1.1", "1.2", "1.3".
tls13 String: Whether or not TLS 1.3 is enabled. Available values: "on", "off".

GetCustomHostnamesResultSslValidationError

Message string: A domain validation error.

Message string: A domain validation error.

message string: A domain validation error.

message String: A domain validation error.

message string: A domain validation error.

message str: A domain validation error.

message String: A domain validation error.

GetCustomHostnamesResultSslValidationRecord

Cname string: The CNAME record hostname for DCV delegation.
CnameTarget string: The CNAME record target value for DCV delegation.
Emails List<string>: The set of email addresses that the certificate authority (CA) will use to complete domain validation.
HttpBody string: The content that the certificate authority (CA) will expect to find at the httpUrl during the domain validation.
HttpUrl string: The url that will be checked during domain validation.
Status string: Status of the validation record.
TxtName string: The hostname that the certificate authority (CA) will check for a TXT record during domain validation .
TxtValue string: The TXT record that the certificate authority (CA) will check during domain validation.

Cname string: The CNAME record hostname for DCV delegation.
CnameTarget string: The CNAME record target value for DCV delegation.
Emails []string: The set of email addresses that the certificate authority (CA) will use to complete domain validation.
HttpBody string: The content that the certificate authority (CA) will expect to find at the httpUrl during the domain validation.
HttpUrl string: The url that will be checked during domain validation.
Status string: Status of the validation record.
TxtName string: The hostname that the certificate authority (CA) will check for a TXT record during domain validation .
TxtValue string: The TXT record that the certificate authority (CA) will check during domain validation.

cname string: The CNAME record hostname for DCV delegation.
cname_target string: The CNAME record target value for DCV delegation.
emails list(string): The set of email addresses that the certificate authority (CA) will use to complete domain validation.
http_body string: The content that the certificate authority (CA) will expect to find at the httpUrl during the domain validation.
http_url string: The url that will be checked during domain validation.
status string: Status of the validation record.
txt_name string: The hostname that the certificate authority (CA) will check for a TXT record during domain validation .
txt_value string: The TXT record that the certificate authority (CA) will check during domain validation.

cname String: The CNAME record hostname for DCV delegation.
cnameTarget String: The CNAME record target value for DCV delegation.
emails List<String>: The set of email addresses that the certificate authority (CA) will use to complete domain validation.
httpBody String: The content that the certificate authority (CA) will expect to find at the httpUrl during the domain validation.
httpUrl String: The url that will be checked during domain validation.
status String: Status of the validation record.
txtName String: The hostname that the certificate authority (CA) will check for a TXT record during domain validation .
txtValue String: The TXT record that the certificate authority (CA) will check during domain validation.

cname string: The CNAME record hostname for DCV delegation.
cnameTarget string: The CNAME record target value for DCV delegation.
emails string[]: The set of email addresses that the certificate authority (CA) will use to complete domain validation.
httpBody string: The content that the certificate authority (CA) will expect to find at the httpUrl during the domain validation.
httpUrl string: The url that will be checked during domain validation.
status string: Status of the validation record.
txtName string: The hostname that the certificate authority (CA) will check for a TXT record during domain validation .
txtValue string: The TXT record that the certificate authority (CA) will check during domain validation.

cname str: The CNAME record hostname for DCV delegation.
cname_target str: The CNAME record target value for DCV delegation.
emails Sequence[str]: The set of email addresses that the certificate authority (CA) will use to complete domain validation.
http_body str: The content that the certificate authority (CA) will expect to find at the httpUrl during the domain validation.
http_url str: The url that will be checked during domain validation.
status str: Status of the validation record.
txt_name str: The hostname that the certificate authority (CA) will check for a TXT record during domain validation .
txt_value str: The TXT record that the certificate authority (CA) will check during domain validation.

cname String: The CNAME record hostname for DCV delegation.
cnameTarget String: The CNAME record target value for DCV delegation.
emails List<String>: The set of email addresses that the certificate authority (CA) will use to complete domain validation.
httpBody String: The content that the certificate authority (CA) will expect to find at the httpUrl during the domain validation.
httpUrl String: The url that will be checked during domain validation.
status String: Status of the validation record.
txtName String: The hostname that the certificate authority (CA) will check for a TXT record during domain validation .
txtValue String: The TXT record that the certificate authority (CA) will check during domain validation.

Package Details

Repository: Cloudflare pulumi/pulumi-cloudflare
License: Apache-2.0
Notes: This Pulumi package is based on the cloudflare Terraform Provider.

Viewing docs for Cloudflare v6.16.0
published on Tuesday, May 19, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-cloudflare

cloudflare.getCustomHostnames

On this page

On this page

Example Usage

Using getCustomHostnames

getCustomHostnames Result

Supporting Types

GetCustomHostnamesHostname

GetCustomHostnamesResult

GetCustomHostnamesResultOwnershipVerification

GetCustomHostnamesResultOwnershipVerificationHttp

GetCustomHostnamesResultSsl

GetCustomHostnamesResultSslDcvDelegationRecord

GetCustomHostnamesResultSslSettings

GetCustomHostnamesResultSslValidationError

GetCustomHostnamesResultSslValidationRecord

Package Details

On this page

On this page