Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. Cloudflare Provider
  4. API Docs
  5. getEmailSecurityDomain
Viewing docs for Cloudflare v6.21.0
published on Thursday, Sep 17, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-cloudflare

cloudflare.getEmailSecurityDomain

cloudflare logo cloudflare logo
Viewing docs for Cloudflare v6.21.0
published on Thursday, Sep 17, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-cloudflare

    Accepted Permissions

    • Cloud Email Security: Read
    • Cloud Email Security: Write

    Example Usage

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

const exampleEmailSecurityDomain = cloudflare.getEmailSecurityDomain({
    accountId: "023e105f4ecef8ad9ca31a8372d0c353",
    domainId: "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
});

    import pulumi
import pulumi_cloudflare as cloudflare

example_email_security_domain = cloudflare.get_email_security_domain(account_id="023e105f4ecef8ad9ca31a8372d0c353",
    domain_id="f174e90a-fafe-4643-bbbc-4a0ed4fc8415")

    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.GetEmailSecurityDomain(ctx, &cloudflare.LookupEmailSecurityDomainArgs{
			AccountId: "023e105f4ecef8ad9ca31a8372d0c353",
			DomainId:  pulumi.StringRef("f174e90a-fafe-4643-bbbc-4a0ed4fc8415"),
		}, 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 exampleEmailSecurityDomain = Cloudflare.GetEmailSecurityDomain.Invoke(new()
    {
        AccountId = "023e105f4ecef8ad9ca31a8372d0c353",
        DomainId = "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
    });

});

    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.GetEmailSecurityDomainArgs;
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 exampleEmailSecurityDomain = CloudflareFunctions.getEmailSecurityDomain(GetEmailSecurityDomainArgs.builder()
            .accountId("023e105f4ecef8ad9ca31a8372d0c353")
            .domainId("f174e90a-fafe-4643-bbbc-4a0ed4fc8415")
            .build());

    }
}

    variables:
  exampleEmailSecurityDomain:
    fn::invoke:
      function: cloudflare:getEmailSecurityDomain
      arguments:
        accountId: 023e105f4ecef8ad9ca31a8372d0c353
        domainId: f174e90a-fafe-4643-bbbc-4a0ed4fc8415

    pulumi {
  required_providers {
    cloudflare = {
      source = "pulumi/cloudflare"
    }
  }
}

data "cloudflare_getemailsecuritydomain" "exampleEmailSecurityDomain" {
  account_id = "023e105f4ecef8ad9ca31a8372d0c353"
  domain_id  = "f174e90a-fafe-4643-bbbc-4a0ed4fc8415"
}

    Using getEmailSecurityDomain

    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 getEmailSecurityDomain(args: GetEmailSecurityDomainArgs, opts?: InvokeOptions): Promise<GetEmailSecurityDomainResult>
function getEmailSecurityDomainOutput(args: GetEmailSecurityDomainOutputArgs, opts?: InvokeOutputOptions): Output<GetEmailSecurityDomainResult>
    def get_email_security_domain(account_id: Optional[str] = None,
                              domain_id: Optional[str] = None,
                              filter: Optional[GetEmailSecurityDomainFilter] = None,
                              opts: Optional[InvokeOptions] = None) -> GetEmailSecurityDomainResult
def get_email_security_domain_output(account_id: pulumi.Input[Optional[str]] = None,
                              domain_id: pulumi.Input[Optional[str]] = None,
                              filter: pulumi.Input[Optional[GetEmailSecurityDomainFilterArgs]] = None,
                              opts: Optional[InvokeOutputOptions] = None) -> Output[GetEmailSecurityDomainResult]
    func LookupEmailSecurityDomain(ctx *Context, args *LookupEmailSecurityDomainArgs, opts ...InvokeOption) (*LookupEmailSecurityDomainResult, error)
func LookupEmailSecurityDomainOutput(ctx *Context, args *LookupEmailSecurityDomainOutputArgs, opts ...InvokeOption) LookupEmailSecurityDomainResultOutput

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

    public static class GetEmailSecurityDomain 
{
    public static Task<GetEmailSecurityDomainResult> InvokeAsync(GetEmailSecurityDomainArgs args, InvokeOptions? opts = null)
    public static Output<GetEmailSecurityDomainResult> Invoke(GetEmailSecurityDomainInvokeArgs args, InvokeOptions? opts = null)
    public static Output<GetEmailSecurityDomainResult> Invoke(GetEmailSecurityDomainInvokeArgs args, InvokeOutputOptions opts)
}
    public static CompletableFuture<GetEmailSecurityDomainResult> getEmailSecurityDomain(GetEmailSecurityDomainArgs args, InvokeOptions options)
public static Output<GetEmailSecurityDomainResult> getEmailSecurityDomain(GetEmailSecurityDomainArgs args, InvokeOptions options)
public static Output<GetEmailSecurityDomainResult> getEmailSecurityDomain(GetEmailSecurityDomainArgs args, InvokeOutputOptions options)

    fn::invoke:
  function: cloudflare:index/getEmailSecurityDomain:getEmailSecurityDomain
  arguments:
    # arguments dictionary
    data "cloudflare_get_email_security_domain" "name" {
    # arguments
}

    The following arguments are supported:

    AccountId string
    Identifier.
    DomainId string
    Domain identifier.
    Filter GetEmailSecurityDomainFilter
    AccountId string
    Identifier.
    DomainId string
    Domain identifier.
    Filter GetEmailSecurityDomainFilter
    account_id string
    Identifier.
    domain_id string
    Domain identifier.
    filter object
    accountId String
    Identifier.
    domainId String
    Domain identifier.
    filter GetEmailSecurityDomainFilter
    accountId string
    Identifier.
    domainId string
    Domain identifier.
    filter GetEmailSecurityDomainFilter
    account_id str
    Identifier.
    domain_id str
    Domain identifier.
    filter GetEmailSecurityDomainFilter
    accountId String
    Identifier.
    domainId String
    Domain identifier.
    filter Property Map

    getEmailSecurityDomain Result

    The following output properties are available:

    AccountId string
    Identifier.
    AllowedDeliveryModes List<string>
    Authorization GetEmailSecurityDomainAuthorization
    CreatedAt string
    DmarcStatus string
    Available values: "none", "good", "invalid".
    Domain string
    DropDispositions List<string>
    EmailsProcessed GetEmailSecurityDomainEmailsProcessed
    Folder string
    Available values: "AllItems", "Inbox".
    Id string
    Domain identifier.
    InboxProvider string
    Available values: "Microsoft", "Google".
    IntegrationId string
    IpRestrictions List<string>
    LastModified string
    Deprecated, use modifiedAt instead. End of life: November 1, 2026.

    Deprecated: Use modifiedAt instead.

    LookbackHops int
    ModifiedAt string
    O365TenantId string
    Regions List<string>
    RequireTlsInbound bool
    RequireTlsOutbound bool
    SpfStatus string
    Available values: "none", "good", "neutral", "open", "invalid".
    Status string
    Available values: "PENDING", "ACTIVE", "FAILED", "TIMEOUT".
    Transport string
    DomainId string
    Domain identifier.
    Filter GetEmailSecurityDomainFilter
    AccountId string
    Identifier.
    AllowedDeliveryModes []string
    Authorization GetEmailSecurityDomainAuthorization
    CreatedAt string
    DmarcStatus string
    Available values: "none", "good", "invalid".
    Domain string
    DropDispositions []string
    EmailsProcessed GetEmailSecurityDomainEmailsProcessed
    Folder string
    Available values: "AllItems", "Inbox".
    Id string
    Domain identifier.
    InboxProvider string
    Available values: "Microsoft", "Google".
    IntegrationId string
    IpRestrictions []string
    LastModified string
    Deprecated, use modifiedAt instead. End of life: November 1, 2026.

    Deprecated: Use modifiedAt instead.

    LookbackHops int
    ModifiedAt string
    O365TenantId string
    Regions []string
    RequireTlsInbound bool
    RequireTlsOutbound bool
    SpfStatus string
    Available values: "none", "good", "neutral", "open", "invalid".
    Status string
    Available values: "PENDING", "ACTIVE", "FAILED", "TIMEOUT".
    Transport string
    DomainId string
    Domain identifier.
    Filter GetEmailSecurityDomainFilter
    account_id string
    Identifier.
    allowed_delivery_modes list(string)
    authorization object
    created_at string
    dmarc_status string
    Available values: "none", "good", "invalid".
    domain string
    drop_dispositions list(string)
    emails_processed object
    folder string
    Available values: "AllItems", "Inbox".
    id string
    Domain identifier.
    inbox_provider string
    Available values: "Microsoft", "Google".
    integration_id string
    ip_restrictions list(string)
    last_modified string
    Deprecated, use modifiedAt instead. End of life: November 1, 2026.

    Deprecated: Use modifiedAt instead.

    lookback_hops number
    modified_at string
    o365_tenant_id string
    regions list(string)
    require_tls_inbound bool
    require_tls_outbound bool
    spf_status string
    Available values: "none", "good", "neutral", "open", "invalid".
    status string
    Available values: "PENDING", "ACTIVE", "FAILED", "TIMEOUT".
    transport string
    domain_id string
    Domain identifier.
    filter object
    accountId String
    Identifier.
    allowedDeliveryModes List<String>
    authorization GetEmailSecurityDomainAuthorization
    createdAt String
    dmarcStatus String
    Available values: "none", "good", "invalid".
    domain String
    dropDispositions List<String>
    emailsProcessed GetEmailSecurityDomainEmailsProcessed
    folder String
    Available values: "AllItems", "Inbox".
    id String
    Domain identifier.
    inboxProvider String
    Available values: "Microsoft", "Google".
    integrationId String
    ipRestrictions List<String>
    lastModified String
    Deprecated, use modifiedAt instead. End of life: November 1, 2026.

    Deprecated: Use modifiedAt instead.

    lookbackHops Integer
    modifiedAt String
    o365TenantId String
    regions List<String>
    requireTlsInbound Boolean
    requireTlsOutbound Boolean
    spfStatus String
    Available values: "none", "good", "neutral", "open", "invalid".
    status String
    Available values: "PENDING", "ACTIVE", "FAILED", "TIMEOUT".
    transport String
    domainId String
    Domain identifier.
    filter GetEmailSecurityDomainFilter
    accountId string
    Identifier.
    allowedDeliveryModes string[]
    authorization GetEmailSecurityDomainAuthorization
    createdAt string
    dmarcStatus string
    Available values: "none", "good", "invalid".
    domain string
    dropDispositions string[]
    emailsProcessed GetEmailSecurityDomainEmailsProcessed
    folder string
    Available values: "AllItems", "Inbox".
    id string
    Domain identifier.
    inboxProvider string
    Available values: "Microsoft", "Google".
    integrationId string
    ipRestrictions string[]
    lastModified string
    Deprecated, use modifiedAt instead. End of life: November 1, 2026.

    Deprecated: Use modifiedAt instead.

    lookbackHops number
    modifiedAt string
    o365TenantId string
    regions string[]
    requireTlsInbound boolean
    requireTlsOutbound boolean
    spfStatus string
    Available values: "none", "good", "neutral", "open", "invalid".
    status string
    Available values: "PENDING", "ACTIVE", "FAILED", "TIMEOUT".
    transport string
    domainId string
    Domain identifier.
    filter GetEmailSecurityDomainFilter
    account_id str
    Identifier.
    allowed_delivery_modes Sequence[str]
    authorization GetEmailSecurityDomainAuthorization
    created_at str
    dmarc_status str
    Available values: "none", "good", "invalid".
    domain str
    drop_dispositions Sequence[str]
    emails_processed GetEmailSecurityDomainEmailsProcessed
    folder str
    Available values: "AllItems", "Inbox".
    id str
    Domain identifier.
    inbox_provider str
    Available values: "Microsoft", "Google".
    integration_id str
    ip_restrictions Sequence[str]
    last_modified str
    Deprecated, use modifiedAt instead. End of life: November 1, 2026.

    Deprecated: Use modifiedAt instead.

    lookback_hops int
    modified_at str
    o365_tenant_id str
    regions Sequence[str]
    require_tls_inbound bool
    require_tls_outbound bool
    spf_status str
    Available values: "none", "good", "neutral", "open", "invalid".
    status str
    Available values: "PENDING", "ACTIVE", "FAILED", "TIMEOUT".
    transport str
    domain_id str
    Domain identifier.
    filter GetEmailSecurityDomainFilter
    accountId String
    Identifier.
    allowedDeliveryModes List<String>
    authorization Property Map
    createdAt String
    dmarcStatus String
    Available values: "none", "good", "invalid".
    domain String
    dropDispositions List<String>
    emailsProcessed Property Map
    folder String
    Available values: "AllItems", "Inbox".
    id String
    Domain identifier.
    inboxProvider String
    Available values: "Microsoft", "Google".
    integrationId String
    ipRestrictions List<String>
    lastModified String
    Deprecated, use modifiedAt instead. End of life: November 1, 2026.

    Deprecated: Use modifiedAt instead.

    lookbackHops Number
    modifiedAt String
    o365TenantId String
    regions List<String>
    requireTlsInbound Boolean
    requireTlsOutbound Boolean
    spfStatus String
    Available values: "none", "good", "neutral", "open", "invalid".
    status String
    Available values: "PENDING", "ACTIVE", "FAILED", "TIMEOUT".
    transport String
    domainId String
    Domain identifier.
    filter Property Map

    Supporting Types

    GetEmailSecurityDomainAuthorization

    authorized Boolean
    statusMessage String
    timestamp String
    authorized boolean
    statusMessage string
    timestamp string
    authorized Boolean
    statusMessage String
    timestamp String

    GetEmailSecurityDomainEmailsProcessed

    GetEmailSecurityDomainFilter

    ActiveDeliveryMode string
    Currently active delivery mode to filter by. Available values: "DIRECT", "BCC", "JOURNAL", "API", "RETRO_SCAN".
    AllowedDeliveryMode string
    Delivery mode to filter by. Available values: "DIRECT", "BCC", "JOURNAL", "API", "RETRO_SCAN".
    Direction string
    The sorting direction. Available values: "asc", "desc".
    Domains List<string>
    Domain names to filter by.
    IntegrationId string
    Integration ID to filter by.
    Order string
    Field to sort by. Available values: "domain", "createdAt".
    Search string
    Search term for filtering records. Behavior may change.
    Status string
    Filters response to domains with the provided status. Available values: "PENDING", "ACTIVE", "FAILED", "TIMEOUT".
    ActiveDeliveryMode string
    Currently active delivery mode to filter by. Available values: "DIRECT", "BCC", "JOURNAL", "API", "RETRO_SCAN".
    AllowedDeliveryMode string
    Delivery mode to filter by. Available values: "DIRECT", "BCC", "JOURNAL", "API", "RETRO_SCAN".
    Direction string
    The sorting direction. Available values: "asc", "desc".
    Domains []string
    Domain names to filter by.
    IntegrationId string
    Integration ID to filter by.
    Order string
    Field to sort by. Available values: "domain", "createdAt".
    Search string
    Search term for filtering records. Behavior may change.
    Status string
    Filters response to domains with the provided status. Available values: "PENDING", "ACTIVE", "FAILED", "TIMEOUT".
    active_delivery_mode string
    Currently active delivery mode to filter by. Available values: "DIRECT", "BCC", "JOURNAL", "API", "RETRO_SCAN".
    allowed_delivery_mode string
    Delivery mode to filter by. Available values: "DIRECT", "BCC", "JOURNAL", "API", "RETRO_SCAN".
    direction string
    The sorting direction. Available values: "asc", "desc".
    domains list(string)
    Domain names to filter by.
    integration_id string
    Integration ID to filter by.
    order string
    Field to sort by. Available values: "domain", "createdAt".
    search string
    Search term for filtering records. Behavior may change.
    status string
    Filters response to domains with the provided status. Available values: "PENDING", "ACTIVE", "FAILED", "TIMEOUT".
    activeDeliveryMode String
    Currently active delivery mode to filter by. Available values: "DIRECT", "BCC", "JOURNAL", "API", "RETRO_SCAN".
    allowedDeliveryMode String
    Delivery mode to filter by. Available values: "DIRECT", "BCC", "JOURNAL", "API", "RETRO_SCAN".
    direction String
    The sorting direction. Available values: "asc", "desc".
    domains List<String>
    Domain names to filter by.
    integrationId String
    Integration ID to filter by.
    order String
    Field to sort by. Available values: "domain", "createdAt".
    search String
    Search term for filtering records. Behavior may change.
    status String
    Filters response to domains with the provided status. Available values: "PENDING", "ACTIVE", "FAILED", "TIMEOUT".
    activeDeliveryMode string
    Currently active delivery mode to filter by. Available values: "DIRECT", "BCC", "JOURNAL", "API", "RETRO_SCAN".
    allowedDeliveryMode string
    Delivery mode to filter by. Available values: "DIRECT", "BCC", "JOURNAL", "API", "RETRO_SCAN".
    direction string
    The sorting direction. Available values: "asc", "desc".
    domains string[]
    Domain names to filter by.
    integrationId string
    Integration ID to filter by.
    order string
    Field to sort by. Available values: "domain", "createdAt".
    search string
    Search term for filtering records. Behavior may change.
    status string
    Filters response to domains with the provided status. Available values: "PENDING", "ACTIVE", "FAILED", "TIMEOUT".
    active_delivery_mode str
    Currently active delivery mode to filter by. Available values: "DIRECT", "BCC", "JOURNAL", "API", "RETRO_SCAN".
    allowed_delivery_mode str
    Delivery mode to filter by. Available values: "DIRECT", "BCC", "JOURNAL", "API", "RETRO_SCAN".
    direction str
    The sorting direction. Available values: "asc", "desc".
    domains Sequence[str]
    Domain names to filter by.
    integration_id str
    Integration ID to filter by.
    order str
    Field to sort by. Available values: "domain", "createdAt".
    search str
    Search term for filtering records. Behavior may change.
    status str
    Filters response to domains with the provided status. Available values: "PENDING", "ACTIVE", "FAILED", "TIMEOUT".
    activeDeliveryMode String
    Currently active delivery mode to filter by. Available values: "DIRECT", "BCC", "JOURNAL", "API", "RETRO_SCAN".
    allowedDeliveryMode String
    Delivery mode to filter by. Available values: "DIRECT", "BCC", "JOURNAL", "API", "RETRO_SCAN".
    direction String
    The sorting direction. Available values: "asc", "desc".
    domains List<String>
    Domain names to filter by.
    integrationId String
    Integration ID to filter by.
    order String
    Field to sort by. Available values: "domain", "createdAt".
    search String
    Search term for filtering records. Behavior may change.
    status String
    Filters response to domains with the provided status. Available values: "PENDING", "ACTIVE", "FAILED", "TIMEOUT".

    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
    Schema (JSON)
    pulumi/pulumi-cloudflare

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial