1. Packages
  2. Cloudflare Provider
  3. API Docs
  4. getRegionalHostname
Viewing docs for Cloudflare v6.13.1
published on Monday, Mar 30, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-cloudflare

cloudflare.getRegionalHostname

cloudflare logo
Viewing docs for Cloudflare v6.13.1
published on Monday, Mar 30, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-cloudflare

    Example Usage

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

const exampleRegionalHostname = cloudflare.getRegionalHostname({
    zoneId: "023e105f4ecef8ad9ca31a8372d0c353",
    hostname: "foo.example.com",
});

    import pulumi
import pulumi_cloudflare as cloudflare

example_regional_hostname = cloudflare.get_regional_hostname(zone_id="023e105f4ecef8ad9ca31a8372d0c353",
    hostname="foo.example.com")

    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.LookupRegionalHostname(ctx, &cloudflare.LookupRegionalHostnameArgs{
			ZoneId:   "023e105f4ecef8ad9ca31a8372d0c353",
			Hostname: "foo.example.com",
		}, 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 exampleRegionalHostname = Cloudflare.GetRegionalHostname.Invoke(new()
    {
        ZoneId = "023e105f4ecef8ad9ca31a8372d0c353",
        Hostname = "foo.example.com",
    });

});

    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.GetRegionalHostnameArgs;
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 exampleRegionalHostname = CloudflareFunctions.getRegionalHostname(GetRegionalHostnameArgs.builder()
            .zoneId("023e105f4ecef8ad9ca31a8372d0c353")
            .hostname("foo.example.com")
            .build());

    }
}

    variables:
  exampleRegionalHostname:
    fn::invoke:
      function: cloudflare:getRegionalHostname
      arguments:
        zoneId: 023e105f4ecef8ad9ca31a8372d0c353
        hostname: foo.example.com

    Using getRegionalHostname

    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 getRegionalHostname(args: GetRegionalHostnameArgs, opts?: InvokeOptions): Promise<GetRegionalHostnameResult>
function getRegionalHostnameOutput(args: GetRegionalHostnameOutputArgs, opts?: InvokeOptions): Output<GetRegionalHostnameResult>
    def get_regional_hostname(hostname: Optional[str] = None,
                          zone_id: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetRegionalHostnameResult
def get_regional_hostname_output(hostname: Optional[pulumi.Input[str]] = None,
                          zone_id: Optional[pulumi.Input[str]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetRegionalHostnameResult]
    func LookupRegionalHostname(ctx *Context, args *LookupRegionalHostnameArgs, opts ...InvokeOption) (*LookupRegionalHostnameResult, error)
func LookupRegionalHostnameOutput(ctx *Context, args *LookupRegionalHostnameOutputArgs, opts ...InvokeOption) LookupRegionalHostnameResultOutput

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

    public static class GetRegionalHostname 
{
    public static Task<GetRegionalHostnameResult> InvokeAsync(GetRegionalHostnameArgs args, InvokeOptions? opts = null)
    public static Output<GetRegionalHostnameResult> Invoke(GetRegionalHostnameInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetRegionalHostnameResult> getRegionalHostname(GetRegionalHostnameArgs args, InvokeOptions options)
public static Output<GetRegionalHostnameResult> getRegionalHostname(GetRegionalHostnameArgs args, InvokeOptions options)

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

    The following arguments are supported:

    Hostname string
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    ZoneId string
    Identifier.
    Hostname string
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    ZoneId string
    Identifier.
    hostname String
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    zoneId String
    Identifier.
    hostname string
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    zoneId string
    Identifier.
    hostname str
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    zone_id str
    Identifier.
    hostname String
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    zoneId String
    Identifier.

    getRegionalHostname Result

    The following output properties are available:

    CreatedOn string
    When the regional hostname was created
    Hostname string
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    Id string
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    RegionKey string
    Identifying key for the region
    Routing string
    Configure which routing method to use for the regional hostname
    ZoneId string
    Identifier.
    CreatedOn string
    When the regional hostname was created
    Hostname string
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    Id string
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    RegionKey string
    Identifying key for the region
    Routing string
    Configure which routing method to use for the regional hostname
    ZoneId string
    Identifier.
    createdOn String
    When the regional hostname was created
    hostname String
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    id String
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    regionKey String
    Identifying key for the region
    routing String
    Configure which routing method to use for the regional hostname
    zoneId String
    Identifier.
    createdOn string
    When the regional hostname was created
    hostname string
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    id string
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    regionKey string
    Identifying key for the region
    routing string
    Configure which routing method to use for the regional hostname
    zoneId string
    Identifier.
    created_on str
    When the regional hostname was created
    hostname str
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    id str
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    region_key str
    Identifying key for the region
    routing str
    Configure which routing method to use for the regional hostname
    zone_id str
    Identifier.
    createdOn String
    When the regional hostname was created
    hostname String
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    id String
    DNS hostname to be regionalized, must be a subdomain of the zone. Wildcards are supported for one level, e.g *.example.com
    regionKey String
    Identifying key for the region
    routing String
    Configure which routing method to use for the regional hostname
    zoneId String
    Identifier.

    Package Details

    Repository
    Cloudflare pulumi/pulumi-cloudflare
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the cloudflare Terraform Provider.
    cloudflare logo
    Viewing docs for Cloudflare v6.13.1
    published on Monday, Mar 30, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-cloudflare
      Try Pulumi Cloud free. Your team will thank you.