1. Packages
  2. Cloudflare Provider
  3. API Docs
  4. getEmailRoutingDns
Viewing docs for Cloudflare v6.13.0
published on Wednesday, Jan 21, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-cloudflare

cloudflare.getEmailRoutingDns

cloudflare logo
Viewing docs for Cloudflare v6.13.0
published on Wednesday, Jan 21, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-cloudflare

    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.LookupEmailRoutingDns(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.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 exampleEmailRoutingDns = CloudflareFunctions.getEmailRoutingDns(GetEmailRoutingDnsArgs.builder()
            .zoneId("023e105f4ecef8ad9ca31a8372d0c353")
            .subdomain("example.net")
            .build());

    }
}

    variables:
  exampleEmailRoutingDns:
    fn::invoke:
      function: cloudflare:getEmailRoutingDns
      arguments:
        zoneId: 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?: InvokeOptions): 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: Optional[pulumi.Input[str]] = None,
                          zone_id: Optional[pulumi.Input[str]] = None,
                          opts: Optional[InvokeOptions] = 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 CompletableFuture<GetEmailRoutingDnsResult> getEmailRoutingDns(GetEmailRoutingDnsArgs args, InvokeOptions options)
public static Output<GetEmailRoutingDnsResult> getEmailRoutingDns(GetEmailRoutingDnsArgs args, InvokeOptions options)

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

    The following arguments are supported:

    ZoneId string
    Identifier.
    Subdomain string
    Domain of your zone.
    ZoneId string
    Identifier.
    Subdomain string
    Domain of your zone.
    zoneId String
    Identifier.
    subdomain String
    Domain of your zone.
    zoneId string
    Identifier.
    subdomain string
    Domain of your zone.
    zone_id str
    Identifier.
    subdomain str
    Domain of your zone.
    zoneId String
    Identifier.
    subdomain String
    Domain of your zone.

    getEmailRoutingDns Result

    The following output properties are available:

    Errors []GetEmailRoutingDnsError
    Id string
    Identifier.
    Messages []GetEmailRoutingDnsMessage
    Result GetEmailRoutingDnsResult
    ResultInfo GetEmailRoutingDnsResultInfo
    Success bool
    Whether the API call was successful.
    ZoneId string
    Identifier.
    Subdomain string
    Domain of your zone.
    errors List<GetEmailRoutingDnsError>
    id String
    Identifier.
    messages List<GetEmailRoutingDnsMessage>
    result GetEmailRoutingDnsResult
    resultInfo GetEmailRoutingDnsResultInfo
    success Boolean
    Whether the API call was successful.
    zoneId String
    Identifier.
    subdomain String
    Domain of your zone.
    errors GetEmailRoutingDnsError[]
    id string
    Identifier.
    messages GetEmailRoutingDnsMessage[]
    result GetEmailRoutingDnsResult
    resultInfo GetEmailRoutingDnsResultInfo
    success boolean
    Whether the API call was successful.
    zoneId string
    Identifier.
    subdomain string
    Domain of your zone.
    errors List<Property Map>
    id String
    Identifier.
    messages List<Property Map>
    result Property Map
    resultInfo Property Map
    success Boolean
    Whether the API call was successful.
    zoneId String
    Identifier.
    subdomain String
    Domain of your zone.

    Supporting Types

    GetEmailRoutingDnsError

    GetEmailRoutingDnsErrorSource

    Pointer string
    Pointer string
    pointer String
    pointer string
    pointer String

    GetEmailRoutingDnsMessage

    GetEmailRoutingDnsMessageSource

    Pointer string
    Pointer string
    pointer String
    pointer string
    pointer String

    GetEmailRoutingDnsResult

    Content string
    DNS record content.
    Errors List<GetEmailRoutingDnsResultError>
    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.
    Records List<GetEmailRoutingDnsResultRecord>
    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.
    Errors []GetEmailRoutingDnsResultError
    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.
    Records []GetEmailRoutingDnsResultRecord
    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.
    errors List<GetEmailRoutingDnsResultError>
    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.
    records List<GetEmailRoutingDnsResultRecord>
    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.
    errors GetEmailRoutingDnsResultError[]
    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.
    records GetEmailRoutingDnsResultRecord[]
    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.
    errors Sequence[GetEmailRoutingDnsResultError]
    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.
    records Sequence[GetEmailRoutingDnsResultRecord]
    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.
    errors List<Property Map>
    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.
    records List<Property Map>
    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".

    GetEmailRoutingDnsResultError

    Code string
    Missing GetEmailRoutingDnsResultErrorMissing
    List of records needed to enable an Email Routing zone.
    Code string
    Missing GetEmailRoutingDnsResultErrorMissing
    List of records needed to enable an Email Routing zone.
    code String
    missing GetEmailRoutingDnsResultErrorMissing
    List of records needed to enable an Email Routing zone.
    code string
    missing GetEmailRoutingDnsResultErrorMissing
    List of records needed to enable an Email Routing zone.
    code str
    missing GetEmailRoutingDnsResultErrorMissing
    List of records needed to enable an Email Routing zone.
    code String
    missing Property Map
    List of records needed to enable an Email Routing zone.

    GetEmailRoutingDnsResultErrorMissing

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

    GetEmailRoutingDnsResultInfo

    EmailRoutingDnsCount double
    Total number of results for the requested service.
    Page double
    Current page within paginated list of results.
    PerPage double
    Number of results per page of results.
    TotalCount double
    Total results available without any search parameters.
    EmailRoutingDnsCount float64
    Total number of results for the requested service.
    Page float64
    Current page within paginated list of results.
    PerPage float64
    Number of results per page of results.
    TotalCount float64
    Total results available without any search parameters.
    emailRoutingDnsCount Double
    Total number of results for the requested service.
    page Double
    Current page within paginated list of results.
    perPage Double
    Number of results per page of results.
    totalCount Double
    Total results available without any search parameters.
    emailRoutingDnsCount number
    Total number of results for the requested service.
    page number
    Current page within paginated list of results.
    perPage number
    Number of results per page of results.
    totalCount number
    Total results available without any search parameters.
    email_routing_dns_count float
    Total number of results for the requested service.
    page float
    Current page within paginated list of results.
    per_page float
    Number of results per page of results.
    total_count float
    Total results available without any search parameters.
    emailRoutingDnsCount Number
    Total number of results for the requested service.
    page Number
    Current page within paginated list of results.
    perPage Number
    Number of results per page of results.
    totalCount Number
    Total results available without any search parameters.

    GetEmailRoutingDnsResultRecord

    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 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
    Viewing docs for Cloudflare v6.13.0
    published on Wednesday, Jan 21, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-cloudflare
      Try Pulumi Cloud free. Your team will thank you.