Cloudflare v6.1.2, Apr 28 25

Cloudflare v6.1.2 published on Monday, Apr 28, 2025 by Pulumi

cloudflare.getCustomHostnames

Explore with Pulumi AI

Cloudflare v6.1.2 published on Monday, Apr 28, 2025 by Pulumi

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",
    direction: "desc",
    hostname: "app.example.com",
    ssl: 0,
});

import pulumi
import pulumi_cloudflare as cloudflare

example_custom_hostnames = cloudflare.get_custom_hostnames(zone_id="023e105f4ecef8ad9ca31a8372d0c353",
    id="0d89c70d-ad9f-4843-b99f-6cc0252067e9",
    direction="desc",
    hostname="app.example.com",
    ssl=0)

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.LookupCustomHostnames(ctx, &cloudflare.LookupCustomHostnamesArgs{
			ZoneId:    "023e105f4ecef8ad9ca31a8372d0c353",
			Id:        pulumi.StringRef("0d89c70d-ad9f-4843-b99f-6cc0252067e9"),
			Direction: pulumi.StringRef("desc"),
			Hostname:  pulumi.StringRef("app.example.com"),
			Ssl:       pulumi.Float64Ref(0),
		}, 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",
        Direction = "desc",
        Hostname = "app.example.com",
        Ssl = 0,
    });

});

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 java.util.List;
import java.util.ArrayList;
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")
            .direction("desc")
            .hostname("app.example.com")
            .ssl(0)
            .build());

    }
}

variables:
  exampleCustomHostnames:
    fn::invoke:
      function: cloudflare:getCustomHostnames
      arguments:
        zoneId: 023e105f4ecef8ad9ca31a8372d0c353
        id: 0d89c70d-ad9f-4843-b99f-6cc0252067e9
        direction: desc
        hostname: app.example.com
        ssl: 0

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(direction: Optional[str] = None,
                         hostname: Optional[str] = None,
                         id: Optional[str] = None,
                         max_items: Optional[int] = None,
                         order: Optional[str] = None,
                         ssl: Optional[float] = None,
                         zone_id: Optional[str] = None,
                         opts: Optional[InvokeOptions] = None) -> GetCustomHostnamesResult
def get_custom_hostnames_output(direction: Optional[pulumi.Input[str]] = None,
                         hostname: Optional[pulumi.Input[str]] = None,
                         id: Optional[pulumi.Input[str]] = None,
                         max_items: Optional[pulumi.Input[int]] = None,
                         order: Optional[pulumi.Input[str]] = None,
                         ssl: Optional[pulumi.Input[float]] = None,
                         zone_id: Optional[pulumi.Input[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

The following arguments are supported:

ZoneId string: Identifier
Direction string: Direction to order hostnames. Available values: "asc", "desc".
Hostname string: Fully qualified domain name to match against. This parameter cannot be used with the 'id' parameter.
Id string: Hostname ID to match against. This ID was generated and returned during the initial custom_hostname 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", "ssl_status".
Ssl double: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.

ZoneId string: Identifier
Direction string: Direction to order hostnames. Available values: "asc", "desc".
Hostname string: Fully qualified domain name to match against. This parameter cannot be used with the 'id' parameter.
Id string: Hostname ID to match against. This ID was generated and returned during the initial custom_hostname 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", "ssl_status".
Ssl float64: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.

zoneId String: Identifier
direction String: Direction to order hostnames. Available values: "asc", "desc".
hostname String: Fully qualified domain name to match against. This parameter cannot be used with the 'id' parameter.
id String: Hostname ID to match against. This ID was generated and returned during the initial custom_hostname 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", "ssl_status".
ssl Double: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.

zoneId string: Identifier
direction string: Direction to order hostnames. Available values: "asc", "desc".
hostname string: Fully qualified domain name to match against. This parameter cannot be used with the 'id' parameter.
id string: Hostname ID to match against. This ID was generated and returned during the initial custom_hostname 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", "ssl_status".
ssl number: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.

zone_id str: Identifier
direction str: Direction to order hostnames. Available values: "asc", "desc".
hostname str: Fully qualified domain name to match against. This parameter cannot be used with the 'id' parameter.
id str: Hostname ID to match against. This ID was generated and returned during the initial custom_hostname 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", "ssl_status".
ssl float: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.

zoneId String: Identifier
direction String: Direction to order hostnames. Available values: "asc", "desc".
hostname String: Fully qualified domain name to match against. This parameter cannot be used with the 'id' parameter.
id String: Hostname ID to match against. This ID was generated and returned during the initial custom_hostname 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", "ssl_status".
ssl Number: Whether to filter hostnames based on if they have SSL enabled. Available values: 0, 1.

getCustomHostnames Result

The following output properties are available:

Order string: Field to order hostnames by. Available values: "ssl", "ssl_status".
Results List<GetCustomHostnamesResult>: The items returned by the data source
ZoneId string: Identifier
Direction string: Direction to order hostnames. Available values: "asc", "desc".
Hostname string: Fully qualified domain name to match against. This parameter cannot be used with the 'id' parameter.
Id string: Hostname ID to match against. This ID was generated and returned during the initial custom_hostname 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.

Order string: Field to order hostnames by. Available values: "ssl", "ssl_status".
Results []GetCustomHostnamesResult: The items returned by the data source
ZoneId string: Identifier
Direction string: Direction to order hostnames. Available values: "asc", "desc".
Hostname string: Fully qualified domain name to match against. This parameter cannot be used with the 'id' parameter.
Id string: Hostname ID to match against. This ID was generated and returned during the initial custom_hostname 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.

order String: Field to order hostnames by. Available values: "ssl", "ssl_status".
results List<GetCustomHostnamesResult>: The items returned by the data source
zoneId String: Identifier
direction String: Direction to order hostnames. Available values: "asc", "desc".
hostname String: Fully qualified domain name to match against. This parameter cannot be used with the 'id' parameter.
id String: Hostname ID to match against. This ID was generated and returned during the initial custom_hostname 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.

order string: Field to order hostnames by. Available values: "ssl", "ssl_status".
results GetCustomHostnamesResult[]: The items returned by the data source
zoneId string: Identifier
direction string: Direction to order hostnames. Available values: "asc", "desc".
hostname string: Fully qualified domain name to match against. This parameter cannot be used with the 'id' parameter.
id string: Hostname ID to match against. This ID was generated and returned during the initial custom_hostname 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.

order str: Field to order hostnames by. Available values: "ssl", "ssl_status".
results Sequence[GetCustomHostnamesResult]: The items returned by the data source
zone_id str: Identifier
direction str: Direction to order hostnames. Available values: "asc", "desc".
hostname str: Fully qualified domain name to match against. This parameter cannot be used with the 'id' parameter.
id str: Hostname ID to match against. This ID was generated and returned during the initial custom_hostname 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.

order String: Field to order hostnames by. Available values: "ssl", "ssl_status".
results List<Property Map>: The items returned by the data source
zoneId String: Identifier
direction String: Direction to order hostnames. Available values: "asc", "desc".
hostname String: Fully qualified domain name to match against. This parameter cannot be used with the 'id' parameter.
id String: Hostname ID to match against. This ID was generated and returned during the initial custom_hostname 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.

Supporting Types

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", "test_failed", "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", "test_failed", "provisioned", "blocked".
VerificationErrors []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", "test_failed", "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", "test_failed", "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", "test_failed", "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", "test_failed", "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 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.

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.
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.
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.

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.
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.
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.
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.
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.

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.
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 str: A domain validation error.

message String: A domain validation error.

GetCustomHostnamesResultSslValidationRecord

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 http_url during the domain validation.
HttpUrl string: The url that will be checked during domain validation.
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.

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 http_url during the domain validation.
HttpUrl string: The url that will be checked during domain validation.
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.

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 http_url during the domain validation.
httpUrl String: The url that will be checked during domain validation.
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.

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 http_url during the domain validation.
httpUrl string: The url that will be checked during domain validation.
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.

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 http_url during the domain validation.
http_url str: The url that will be checked during domain validation.
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.

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 http_url during the domain validation.
httpUrl String: The url that will be checked during domain validation.
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.

Cloudflare v6.1.2 published on Monday, Apr 28, 2025 by Pulumi

pulumi/pulumi-cloudflare

cloudflare.getCustomHostnames

On this page

On this page

Example Usage

Using getCustomHostnames

getCustomHostnames Result

Supporting Types

GetCustomHostnamesResult

GetCustomHostnamesResultOwnershipVerification

GetCustomHostnamesResultOwnershipVerificationHttp

GetCustomHostnamesResultSsl

GetCustomHostnamesResultSslSettings

GetCustomHostnamesResultSslValidationError

GetCustomHostnamesResultSslValidationRecord

Package Details

On this page

On this page