1. Packages
  2. Cloudflare Provider
  3. API Docs
  4. getRegionalHostname
Cloudflare v6.1.2 published on Monday, Apr 28, 2025 by Pulumi

cloudflare.getRegionalHostname

Explore with Pulumi AI

cloudflare logo
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 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: pulumi.StringRef("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:

    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 string
    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 str
    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

    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
    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
    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
    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
    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
    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
    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
    Cloudflare v6.1.2 published on Monday, Apr 28, 2025 by Pulumi