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

cloudflare.getEmailRoutingDns

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 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 List<GetEmailRoutingDnsError>
    Id string
    The provider-assigned unique ID for this managed resource.
    Messages List<GetEmailRoutingDnsMessage>
    Result GetEmailRoutingDnsResult
    ResultInfo GetEmailRoutingDnsResultInfo
    Success bool
    Whether the API call was successful
    ZoneId string
    Identifier
    Subdomain string
    Domain of your zone.
    Errors []GetEmailRoutingDnsError
    Id string
    The provider-assigned unique ID for this managed resource.
    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
    The provider-assigned unique ID for this managed resource.
    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
    The provider-assigned unique ID for this managed resource.
    messages GetEmailRoutingDnsMessage[]
    result GetEmailRoutingDnsResult
    resultInfo GetEmailRoutingDnsResultInfo
    success boolean
    Whether the API call was successful
    zoneId string
    Identifier
    subdomain string
    Domain of your zone.
    errors Sequence[GetEmailRoutingDnsError]
    id str
    The provider-assigned unique ID for this managed resource.
    messages Sequence[GetEmailRoutingDnsMessage]
    result GetEmailRoutingDnsResult
    result_info GetEmailRoutingDnsResultInfo
    success bool
    Whether the API call was successful
    zone_id str
    Identifier
    subdomain str
    Domain of your zone.
    errors List<Property Map>
    id String
    The provider-assigned unique ID for this managed resource.
    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

    Code int
    Message string
    Code int
    Message string
    code Integer
    message String
    code number
    message string
    code int
    message str
    code Number
    message String

    GetEmailRoutingDnsMessage

    Code int
    Message string
    Code int
    Message string
    code Integer
    message String
    code number
    message string
    code int
    message str
    code Number
    message 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

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