1. Registry
  2. Packages
  3. Cloudflare Provider
  4. API Docs
  5. getEmailRoutingDns
Viewing docs for Cloudflare v6.21.0
published on Thursday, Sep 17, 2026 by Pulumi
cloudflare logo cloudflare logo
Viewing docs for Cloudflare v6.21.0
published on Thursday, Sep 17, 2026 by Pulumi

    Accepted Permissions

    • Zone Settings Read
    • Zone Settings Write

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as cloudflare from "@pulumi/cloudflare";
    
    const exampleEmailRoutingDns = cloudflare.getEmailRoutingDns({
        zoneId: "023e105f4ecef8ad9ca31a8372d0c353",
        subdomain: "example.net",
    });
    
    import pulumi
    import pulumi_cloudflare as cloudflare
    
    example_email_routing_dns = cloudflare.get_email_routing_dns(zone_id="023e105f4ecef8ad9ca31a8372d0c353",
        subdomain="example.net")
    
    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.GetEmailRoutingDns(ctx, &cloudflare.LookupEmailRoutingDnsArgs{
    			ZoneId:    "023e105f4ecef8ad9ca31a8372d0c353",
    			Subdomain: pulumi.StringRef("example.net"),
    		}, 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 exampleEmailRoutingDns = Cloudflare.GetEmailRoutingDns.Invoke(new()
        {
            ZoneId = "023e105f4ecef8ad9ca31a8372d0c353",
            Subdomain = "example.net",
        });
    
    });
    
    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.GetEmailRoutingDnsArgs;
    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 exampleEmailRoutingDns = CloudflareFunctions.getEmailRoutingDns(GetEmailRoutingDnsArgs.builder()
                .zoneId("023e105f4ecef8ad9ca31a8372d0c353")
                .subdomain("example.net")
                .build());
    
        }
    }
    
    variables:
      exampleEmailRoutingDns:
        fn::invoke:
          function: cloudflare:getEmailRoutingDns
          arguments:
            zoneId: 023e105f4ecef8ad9ca31a8372d0c353
            subdomain: example.net
    
    pulumi {
      required_providers {
        cloudflare = {
          source = "pulumi/cloudflare"
        }
      }
    }
    
    data "cloudflare_getemailroutingdns" "exampleEmailRoutingDns" {
      zone_id   = "023e105f4ecef8ad9ca31a8372d0c353"
      subdomain = "example.net"
    }
    

    Using getEmailRoutingDns

    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 getEmailRoutingDns(args: GetEmailRoutingDnsArgs, opts?: InvokeOptions): Promise<GetEmailRoutingDnsResult>
    function getEmailRoutingDnsOutput(args: GetEmailRoutingDnsOutputArgs, opts?: InvokeOutputOptions): Output<GetEmailRoutingDnsResult>
    def get_email_routing_dns(subdomain: Optional[str] = None,
                              zone_id: Optional[str] = None,
                              opts: Optional[InvokeOptions] = None) -> GetEmailRoutingDnsResult
    def get_email_routing_dns_output(subdomain: pulumi.Input[Optional[str]] = None,
                              zone_id: pulumi.Input[Optional[str]] = None,
                              opts: Optional[InvokeOutputOptions] = None) -> Output[GetEmailRoutingDnsResult]
    func LookupEmailRoutingDns(ctx *Context, args *LookupEmailRoutingDnsArgs, opts ...InvokeOption) (*LookupEmailRoutingDnsResult, error)
    func LookupEmailRoutingDnsOutput(ctx *Context, args *LookupEmailRoutingDnsOutputArgs, opts ...InvokeOption) LookupEmailRoutingDnsResultOutput

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

    public static class GetEmailRoutingDns 
    {
        public static Task<GetEmailRoutingDnsResult> InvokeAsync(GetEmailRoutingDnsArgs args, InvokeOptions? opts = null)
        public static Output<GetEmailRoutingDnsResult> Invoke(GetEmailRoutingDnsInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetEmailRoutingDnsResult> Invoke(GetEmailRoutingDnsInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetEmailRoutingDnsResult> getEmailRoutingDns(GetEmailRoutingDnsArgs args, InvokeOptions options)
    public static Output<GetEmailRoutingDnsResult> getEmailRoutingDns(GetEmailRoutingDnsArgs args, InvokeOptions options)
    public static Output<GetEmailRoutingDnsResult> getEmailRoutingDns(GetEmailRoutingDnsArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: cloudflare:index/getEmailRoutingDns:getEmailRoutingDns
      arguments:
        # arguments dictionary
    data "cloudflare_get_email_routing_dns" "name" {
        # arguments
    }

    The following arguments are supported:

    ZoneId string
    Identifier.
    Subdomain string
    Deprecated. When supplied, the response shape differs from the documented default and is not modeled in generated SDKs. Do not rely on this parameter.
    ZoneId string
    Identifier.
    Subdomain string
    Deprecated. When supplied, the response shape differs from the documented default and is not modeled in generated SDKs. Do not rely on this parameter.
    zone_id string
    Identifier.
    subdomain string
    Deprecated. When supplied, the response shape differs from the documented default and is not modeled in generated SDKs. Do not rely on this parameter.
    zoneId String
    Identifier.
    subdomain String
    Deprecated. When supplied, the response shape differs from the documented default and is not modeled in generated SDKs. Do not rely on this parameter.
    zoneId string
    Identifier.
    subdomain string
    Deprecated. When supplied, the response shape differs from the documented default and is not modeled in generated SDKs. Do not rely on this parameter.
    zone_id str
    Identifier.
    subdomain str
    Deprecated. When supplied, the response shape differs from the documented default and is not modeled in generated SDKs. Do not rely on this parameter.
    zoneId String
    Identifier.
    subdomain String
    Deprecated. When supplied, the response shape differs from the documented default and is not modeled in generated SDKs. Do not rely on this parameter.

    getEmailRoutingDns Result

    The following output properties are available:

    Dns List<GetEmailRoutingDnsDn>
    Id string
    Identifier.
    ZoneId string
    Identifier.
    Subdomain string
    Deprecated. When supplied, the response shape differs from the documented default and is not modeled in generated SDKs. Do not rely on this parameter.
    Dns []GetEmailRoutingDnsDn
    Id string
    Identifier.
    ZoneId string
    Identifier.
    Subdomain string
    Deprecated. When supplied, the response shape differs from the documented default and is not modeled in generated SDKs. Do not rely on this parameter.
    dns list(object)
    id string
    Identifier.
    zone_id string
    Identifier.
    subdomain string
    Deprecated. When supplied, the response shape differs from the documented default and is not modeled in generated SDKs. Do not rely on this parameter.
    dns List<GetEmailRoutingDnsDn>
    id String
    Identifier.
    zoneId String
    Identifier.
    subdomain String
    Deprecated. When supplied, the response shape differs from the documented default and is not modeled in generated SDKs. Do not rely on this parameter.
    dns GetEmailRoutingDnsDn[]
    id string
    Identifier.
    zoneId string
    Identifier.
    subdomain string
    Deprecated. When supplied, the response shape differs from the documented default and is not modeled in generated SDKs. Do not rely on this parameter.
    dns Sequence[GetEmailRoutingDnsDn]
    id str
    Identifier.
    zone_id str
    Identifier.
    subdomain str
    Deprecated. When supplied, the response shape differs from the documented default and is not modeled in generated SDKs. Do not rely on this parameter.
    dns List<Property Map>
    id String
    Identifier.
    zoneId String
    Identifier.
    subdomain String
    Deprecated. When supplied, the response shape differs from the documented default and is not modeled in generated SDKs. Do not rely on this parameter.

    Supporting Types

    GetEmailRoutingDnsDn

    Content string
    DNS record content.
    Name string
    DNS record name (or @ for the zone apex).
    Priority double
    Required for MX, SRV and URI records. Unused by other record types. Records with lower priorities are preferred.
    Ttl double
    Time to live, in seconds, of the DNS record. Must be between 60 and 86400, or 1 for 'automatic'.
    Type string
    DNS record type. Available values: "A", "AAAA", "CNAME", "HTTPS", "TXT", "SRV", "LOC", "MX", "NS", "CERT", "DNSKEY", "DS", "NAPTR", "SMIMEA", "SSHFP", "SVCB", "TLSA", "URI".
    Content string
    DNS record content.
    Name string
    DNS record name (or @ for the zone apex).
    Priority float64
    Required for MX, SRV and URI records. Unused by other record types. Records with lower priorities are preferred.
    Ttl float64
    Time to live, in seconds, of the DNS record. Must be between 60 and 86400, or 1 for 'automatic'.
    Type string
    DNS record type. Available values: "A", "AAAA", "CNAME", "HTTPS", "TXT", "SRV", "LOC", "MX", "NS", "CERT", "DNSKEY", "DS", "NAPTR", "SMIMEA", "SSHFP", "SVCB", "TLSA", "URI".
    content string
    DNS record content.
    name string
    DNS record name (or @ for the zone apex).
    priority number
    Required for MX, SRV and URI records. Unused by other record types. Records with lower priorities are preferred.
    ttl number
    Time to live, in seconds, of the DNS record. Must be between 60 and 86400, or 1 for 'automatic'.
    type string
    DNS record type. Available values: "A", "AAAA", "CNAME", "HTTPS", "TXT", "SRV", "LOC", "MX", "NS", "CERT", "DNSKEY", "DS", "NAPTR", "SMIMEA", "SSHFP", "SVCB", "TLSA", "URI".
    content String
    DNS record content.
    name String
    DNS record name (or @ for the zone apex).
    priority Double
    Required for MX, SRV and URI records. Unused by other record types. Records with lower priorities are preferred.
    ttl Double
    Time to live, in seconds, of the DNS record. Must be between 60 and 86400, or 1 for 'automatic'.
    type String
    DNS record type. Available values: "A", "AAAA", "CNAME", "HTTPS", "TXT", "SRV", "LOC", "MX", "NS", "CERT", "DNSKEY", "DS", "NAPTR", "SMIMEA", "SSHFP", "SVCB", "TLSA", "URI".
    content string
    DNS record content.
    name string
    DNS record name (or @ for the zone apex).
    priority number
    Required for MX, SRV and URI records. Unused by other record types. Records with lower priorities are preferred.
    ttl number
    Time to live, in seconds, of the DNS record. Must be between 60 and 86400, or 1 for 'automatic'.
    type string
    DNS record type. Available values: "A", "AAAA", "CNAME", "HTTPS", "TXT", "SRV", "LOC", "MX", "NS", "CERT", "DNSKEY", "DS", "NAPTR", "SMIMEA", "SSHFP", "SVCB", "TLSA", "URI".
    content str
    DNS record content.
    name str
    DNS record name (or @ for the zone apex).
    priority float
    Required for MX, SRV and URI records. Unused by other record types. Records with lower priorities are preferred.
    ttl float
    Time to live, in seconds, of the DNS record. Must be between 60 and 86400, or 1 for 'automatic'.
    type str
    DNS record type. Available values: "A", "AAAA", "CNAME", "HTTPS", "TXT", "SRV", "LOC", "MX", "NS", "CERT", "DNSKEY", "DS", "NAPTR", "SMIMEA", "SSHFP", "SVCB", "TLSA", "URI".
    content String
    DNS record content.
    name String
    DNS record name (or @ for the zone apex).
    priority Number
    Required for MX, SRV and URI records. Unused by other record types. Records with lower priorities are preferred.
    ttl Number
    Time to live, in seconds, of the DNS record. Must be between 60 and 86400, or 1 for 'automatic'.
    type String
    DNS record type. Available values: "A", "AAAA", "CNAME", "HTTPS", "TXT", "SRV", "LOC", "MX", "NS", "CERT", "DNSKEY", "DS", "NAPTR", "SMIMEA", "SSHFP", "SVCB", "TLSA", "URI".

    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 logo
    Viewing docs for Cloudflare v6.21.0
    published on Thursday, Sep 17, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial