CustomHostname

class CustomHostname : KotlinCustomResource

Provides a Cloudflare custom hostname (also known as SSL for SaaS) resource.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as cloudflare from "@pulumi/cloudflare";
const example = new cloudflare.CustomHostname("example", {
zoneId: "0da42c8d2132a9ddaf714f9e7c920711",
hostname: "hostname.example.com",
ssls: [{
method: "txt",
}],
});
import pulumi
import pulumi_cloudflare as cloudflare
example = cloudflare.CustomHostname("example",
zone_id="0da42c8d2132a9ddaf714f9e7c920711",
hostname="hostname.example.com",
ssls=[{
"method": "txt",
}])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Cloudflare = Pulumi.Cloudflare;
return await Deployment.RunAsync(() =>
{
var example = new Cloudflare.CustomHostname("example", new()
{
ZoneId = "0da42c8d2132a9ddaf714f9e7c920711",
Hostname = "hostname.example.com",
Ssls = new[]
{
new Cloudflare.Inputs.CustomHostnameSslArgs
{
Method = "txt",
},
},
});
});
package main
import (
"github.com/pulumi/pulumi-cloudflare/sdk/v5/go/cloudflare"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := cloudflare.NewCustomHostname(ctx, "example", &cloudflare.CustomHostnameArgs{
ZoneId: pulumi.String("0da42c8d2132a9ddaf714f9e7c920711"),
Hostname: pulumi.String("hostname.example.com"),
Ssls: cloudflare.CustomHostnameSslArray{
&cloudflare.CustomHostnameSslArgs{
Method: pulumi.String("txt"),
},
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.cloudflare.CustomHostname;
import com.pulumi.cloudflare.CustomHostnameArgs;
import com.pulumi.cloudflare.inputs.CustomHostnameSslArgs;
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) {
var example = new CustomHostname("example", CustomHostnameArgs.builder()
.zoneId("0da42c8d2132a9ddaf714f9e7c920711")
.hostname("hostname.example.com")
.ssls(CustomHostnameSslArgs.builder()
.method("txt")
.build())
.build());
}
}
resources:
example:
type: cloudflare:CustomHostname
properties:
zoneId: 0da42c8d2132a9ddaf714f9e7c920711
hostname: hostname.example.com
ssls:
- method: txt

Import

$ pulumi import cloudflare:index/customHostname:CustomHostname example 1d5fdc9e88c8a8c4518b068cd94331fe/0d89c70d-ad9f-4843-b99f-6cc0252067e9

Properties

Link copied to clipboard

Custom metadata associated with custom hostname. Only supports primitive string values, all other values are accessible via the API directly.

Link copied to clipboard

The custom origin server used for certificates.

Link copied to clipboard
val customOriginSni: Output<String>?

The custom origin SNI used for certificates.

Link copied to clipboard
val hostname: Output<String>

Hostname you intend to request a certificate for. Modifying this attribute will force creation of a new resource.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val ssls: Output<List<CustomHostnameSsl>>?

SSL properties used when creating the custom hostname.

Link copied to clipboard
val status: Output<String>

Status of the certificate.

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard

Whether to wait for a custom hostname SSL sub-object to reach status pending_validation during creation. Defaults to false.

Link copied to clipboard
val zoneId: Output<String>

The zone identifier to target for the resource. Modifying this attribute will force creation of a new resource.