1. Registry
  2. Packages
  3. AWS
  4. API Docs
  5. sesv2
  6. getEmailIdentity
Viewing docs for AWS v7.46.0
published on Thursday, Sep 10, 2026 by Pulumi
aws logo aws logo
Viewing docs for AWS v7.46.0
published on Thursday, Sep 10, 2026 by Pulumi

    Data source for managing an AWS SESv2 (Simple Email V2) Email Identity.

    Example Usage

    Basic Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const example = aws.sesv2.getEmailIdentity({
        emailIdentity: "example.com",
    });
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.sesv2.get_email_identity(email_identity="example.com")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/sesv2"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := sesv2.LookupEmailIdentity(ctx, &sesv2.LookupEmailIdentityArgs{
    			EmailIdentity: "example.com",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var example = Aws.SesV2.GetEmailIdentity.Invoke(new()
        {
            EmailIdentity = "example.com",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.sesv2.Sesv2Functions;
    import com.pulumi.aws.sesv2.inputs.GetEmailIdentityArgs;
    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 example = Sesv2Functions.getEmailIdentity(GetEmailIdentityArgs.builder()
                .emailIdentity("example.com")
                .build());
    
        }
    }
    
    variables:
      example:
        fn::invoke:
          function: aws:sesv2:getEmailIdentity
          arguments:
            emailIdentity: example.com
    
    pulumi {
      required_providers {
        aws = {
          source = "pulumi/aws"
        }
      }
    }
    
    data "aws_sesv2_getemailidentity" "example" {
      email_identity = "example.com"
    }
    

    Using getEmailIdentity

    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 getEmailIdentity(args: GetEmailIdentityArgs, opts?: InvokeOptions): Promise<GetEmailIdentityResult>
    function getEmailIdentityOutput(args: GetEmailIdentityOutputArgs, opts?: InvokeOutputOptions): Output<GetEmailIdentityResult>
    def get_email_identity(email_identity: Optional[str] = None,
                           region: Optional[str] = None,
                           tags: Optional[Mapping[str, str]] = None,
                           opts: Optional[InvokeOptions] = None) -> GetEmailIdentityResult
    def get_email_identity_output(email_identity: pulumi.Input[Optional[str]] = None,
                           region: pulumi.Input[Optional[str]] = None,
                           tags: pulumi.Input[Optional[Mapping[str, pulumi.Input[str]]]] = None,
                           opts: Optional[InvokeOutputOptions] = None) -> Output[GetEmailIdentityResult]
    func LookupEmailIdentity(ctx *Context, args *LookupEmailIdentityArgs, opts ...InvokeOption) (*LookupEmailIdentityResult, error)
    func LookupEmailIdentityOutput(ctx *Context, args *LookupEmailIdentityOutputArgs, opts ...InvokeOption) LookupEmailIdentityResultOutput

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

    public static class GetEmailIdentity 
    {
        public static Task<GetEmailIdentityResult> InvokeAsync(GetEmailIdentityArgs args, InvokeOptions? opts = null)
        public static Output<GetEmailIdentityResult> Invoke(GetEmailIdentityInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetEmailIdentityResult> Invoke(GetEmailIdentityInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetEmailIdentityResult> getEmailIdentity(GetEmailIdentityArgs args, InvokeOptions options)
    public static Output<GetEmailIdentityResult> getEmailIdentity(GetEmailIdentityArgs args, InvokeOptions options)
    public static Output<GetEmailIdentityResult> getEmailIdentity(GetEmailIdentityArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: aws:sesv2/getEmailIdentity:getEmailIdentity
      arguments:
        # arguments dictionary
    data "aws_sesv2_get_email_identity" "name" {
        # arguments
    }

    The following arguments are supported:

    EmailIdentity string
    Name of the email identity.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Tags Dictionary<string, string>
    Key-value mapping of resource tags.
    EmailIdentity string
    Name of the email identity.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Tags map[string]string
    Key-value mapping of resource tags.
    email_identity string
    Name of the email identity.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags map(string)
    Key-value mapping of resource tags.
    emailIdentity String
    Name of the email identity.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Map<String,String>
    Key-value mapping of resource tags.
    emailIdentity string
    Name of the email identity.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags {[key: string]: string}
    Key-value mapping of resource tags.
    email_identity str
    Name of the email identity.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Mapping[str, str]
    Key-value mapping of resource tags.
    emailIdentity String
    Name of the email identity.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Map<String>
    Key-value mapping of resource tags.

    getEmailIdentity Result

    The following output properties are available:

    Arn string
    ARN of the Email Identity.
    ConfigurationSetName string
    Configuration set associated with the email identity.
    DkimSigningAttributes List<GetEmailIdentityDkimSigningAttribute>
    List of objects that contains at most one element with information about the private key and selector that you want to use to configure DKIM for the identity for Bring Your Own DKIM (BYODKIM) for the identity, or, configures the key length to be used for Easy DKIM.
    EmailIdentity string
    Id string
    The provider-assigned unique ID for this managed resource.
    IdentityType string
    Email identity type. Valid values: EMAIL_ADDRESS, DOMAIN.
    Region string
    Tags Dictionary<string, string>
    Key-value mapping of resource tags.
    VerificationStatus string
    Verification status of the identity. The status can be one of the following: PENDING, SUCCESS, FAILED, TEMPORARY_FAILURE, and NOT_STARTED.
    VerifiedForSendingStatus bool
    Whether or not the identity is verified.
    Arn string
    ARN of the Email Identity.
    ConfigurationSetName string
    Configuration set associated with the email identity.
    DkimSigningAttributes []GetEmailIdentityDkimSigningAttribute
    List of objects that contains at most one element with information about the private key and selector that you want to use to configure DKIM for the identity for Bring Your Own DKIM (BYODKIM) for the identity, or, configures the key length to be used for Easy DKIM.
    EmailIdentity string
    Id string
    The provider-assigned unique ID for this managed resource.
    IdentityType string
    Email identity type. Valid values: EMAIL_ADDRESS, DOMAIN.
    Region string
    Tags map[string]string
    Key-value mapping of resource tags.
    VerificationStatus string
    Verification status of the identity. The status can be one of the following: PENDING, SUCCESS, FAILED, TEMPORARY_FAILURE, and NOT_STARTED.
    VerifiedForSendingStatus bool
    Whether or not the identity is verified.
    arn string
    ARN of the Email Identity.
    configuration_set_name string
    Configuration set associated with the email identity.
    dkim_signing_attributes list(object)
    List of objects that contains at most one element with information about the private key and selector that you want to use to configure DKIM for the identity for Bring Your Own DKIM (BYODKIM) for the identity, or, configures the key length to be used for Easy DKIM.
    email_identity string
    id string
    The provider-assigned unique ID for this managed resource.
    identity_type string
    Email identity type. Valid values: EMAIL_ADDRESS, DOMAIN.
    region string
    tags map(string)
    Key-value mapping of resource tags.
    verification_status string
    Verification status of the identity. The status can be one of the following: PENDING, SUCCESS, FAILED, TEMPORARY_FAILURE, and NOT_STARTED.
    verified_for_sending_status bool
    Whether or not the identity is verified.
    arn String
    ARN of the Email Identity.
    configurationSetName String
    Configuration set associated with the email identity.
    dkimSigningAttributes List<GetEmailIdentityDkimSigningAttribute>
    List of objects that contains at most one element with information about the private key and selector that you want to use to configure DKIM for the identity for Bring Your Own DKIM (BYODKIM) for the identity, or, configures the key length to be used for Easy DKIM.
    emailIdentity String
    id String
    The provider-assigned unique ID for this managed resource.
    identityType String
    Email identity type. Valid values: EMAIL_ADDRESS, DOMAIN.
    region String
    tags Map<String,String>
    Key-value mapping of resource tags.
    verificationStatus String
    Verification status of the identity. The status can be one of the following: PENDING, SUCCESS, FAILED, TEMPORARY_FAILURE, and NOT_STARTED.
    verifiedForSendingStatus Boolean
    Whether or not the identity is verified.
    arn string
    ARN of the Email Identity.
    configurationSetName string
    Configuration set associated with the email identity.
    dkimSigningAttributes GetEmailIdentityDkimSigningAttribute[]
    List of objects that contains at most one element with information about the private key and selector that you want to use to configure DKIM for the identity for Bring Your Own DKIM (BYODKIM) for the identity, or, configures the key length to be used for Easy DKIM.
    emailIdentity string
    id string
    The provider-assigned unique ID for this managed resource.
    identityType string
    Email identity type. Valid values: EMAIL_ADDRESS, DOMAIN.
    region string
    tags {[key: string]: string}
    Key-value mapping of resource tags.
    verificationStatus string
    Verification status of the identity. The status can be one of the following: PENDING, SUCCESS, FAILED, TEMPORARY_FAILURE, and NOT_STARTED.
    verifiedForSendingStatus boolean
    Whether or not the identity is verified.
    arn str
    ARN of the Email Identity.
    configuration_set_name str
    Configuration set associated with the email identity.
    dkim_signing_attributes Sequence[GetEmailIdentityDkimSigningAttribute]
    List of objects that contains at most one element with information about the private key and selector that you want to use to configure DKIM for the identity for Bring Your Own DKIM (BYODKIM) for the identity, or, configures the key length to be used for Easy DKIM.
    email_identity str
    id str
    The provider-assigned unique ID for this managed resource.
    identity_type str
    Email identity type. Valid values: EMAIL_ADDRESS, DOMAIN.
    region str
    tags Mapping[str, str]
    Key-value mapping of resource tags.
    verification_status str
    Verification status of the identity. The status can be one of the following: PENDING, SUCCESS, FAILED, TEMPORARY_FAILURE, and NOT_STARTED.
    verified_for_sending_status bool
    Whether or not the identity is verified.
    arn String
    ARN of the Email Identity.
    configurationSetName String
    Configuration set associated with the email identity.
    dkimSigningAttributes List<Property Map>
    List of objects that contains at most one element with information about the private key and selector that you want to use to configure DKIM for the identity for Bring Your Own DKIM (BYODKIM) for the identity, or, configures the key length to be used for Easy DKIM.
    emailIdentity String
    id String
    The provider-assigned unique ID for this managed resource.
    identityType String
    Email identity type. Valid values: EMAIL_ADDRESS, DOMAIN.
    region String
    tags Map<String>
    Key-value mapping of resource tags.
    verificationStatus String
    Verification status of the identity. The status can be one of the following: PENDING, SUCCESS, FAILED, TEMPORARY_FAILURE, and NOT_STARTED.
    verifiedForSendingStatus Boolean
    Whether or not the identity is verified.

    Supporting Types

    GetEmailIdentityDkimSigningAttribute

    CurrentSigningKeyLength string
    [Easy DKIM] The key length of the DKIM key pair in use.
    DomainSigningPrivateKey string
    [Bring Your Own DKIM] Private key used to generate DKIM signatures.
    DomainSigningSelector string
    [Bring Your Own DKIM] Selector added to the DNS configuration for the domain.
    LastKeyGenerationTimestamp string
    [Easy DKIM] The last time a key pair was generated for this identity.
    NextSigningKeyLength string
    [Easy DKIM] The key length of the future DKIM key pair to be generated. This can be changed at most once per day.
    SigningAttributesOrigin string
    String that indicates how DKIM was configured for the identity. AWS_SES indicates that DKIM was configured for the identity by using Easy DKIM. EXTERNAL indicates that DKIM was configured for the identity by using Bring Your Own DKIM (BYODKIM).
    Status string
    Whether or not Amazon SES has successfully located the DKIM records in the DNS records for the domain. See the AWS SES API v2 Reference for supported statuses.
    Tokens List<string>
    If you used Easy DKIM to configure DKIM authentication for the domain, then this object contains a set of unique strings that you use to create a set of CNAME records that you add to the DNS configuration for your domain. When Amazon SES detects these records in the DNS configuration for your domain, the DKIM authentication process is complete. If you configured DKIM authentication for the domain by providing your own public-private key pair, then this object contains the selector for the public key.
    CurrentSigningKeyLength string
    [Easy DKIM] The key length of the DKIM key pair in use.
    DomainSigningPrivateKey string
    [Bring Your Own DKIM] Private key used to generate DKIM signatures.
    DomainSigningSelector string
    [Bring Your Own DKIM] Selector added to the DNS configuration for the domain.
    LastKeyGenerationTimestamp string
    [Easy DKIM] The last time a key pair was generated for this identity.
    NextSigningKeyLength string
    [Easy DKIM] The key length of the future DKIM key pair to be generated. This can be changed at most once per day.
    SigningAttributesOrigin string
    String that indicates how DKIM was configured for the identity. AWS_SES indicates that DKIM was configured for the identity by using Easy DKIM. EXTERNAL indicates that DKIM was configured for the identity by using Bring Your Own DKIM (BYODKIM).
    Status string
    Whether or not Amazon SES has successfully located the DKIM records in the DNS records for the domain. See the AWS SES API v2 Reference for supported statuses.
    Tokens []string
    If you used Easy DKIM to configure DKIM authentication for the domain, then this object contains a set of unique strings that you use to create a set of CNAME records that you add to the DNS configuration for your domain. When Amazon SES detects these records in the DNS configuration for your domain, the DKIM authentication process is complete. If you configured DKIM authentication for the domain by providing your own public-private key pair, then this object contains the selector for the public key.
    current_signing_key_length string
    [Easy DKIM] The key length of the DKIM key pair in use.
    domain_signing_private_key string
    [Bring Your Own DKIM] Private key used to generate DKIM signatures.
    domain_signing_selector string
    [Bring Your Own DKIM] Selector added to the DNS configuration for the domain.
    last_key_generation_timestamp string
    [Easy DKIM] The last time a key pair was generated for this identity.
    next_signing_key_length string
    [Easy DKIM] The key length of the future DKIM key pair to be generated. This can be changed at most once per day.
    signing_attributes_origin string
    String that indicates how DKIM was configured for the identity. AWS_SES indicates that DKIM was configured for the identity by using Easy DKIM. EXTERNAL indicates that DKIM was configured for the identity by using Bring Your Own DKIM (BYODKIM).
    status string
    Whether or not Amazon SES has successfully located the DKIM records in the DNS records for the domain. See the AWS SES API v2 Reference for supported statuses.
    tokens list(string)
    If you used Easy DKIM to configure DKIM authentication for the domain, then this object contains a set of unique strings that you use to create a set of CNAME records that you add to the DNS configuration for your domain. When Amazon SES detects these records in the DNS configuration for your domain, the DKIM authentication process is complete. If you configured DKIM authentication for the domain by providing your own public-private key pair, then this object contains the selector for the public key.
    currentSigningKeyLength String
    [Easy DKIM] The key length of the DKIM key pair in use.
    domainSigningPrivateKey String
    [Bring Your Own DKIM] Private key used to generate DKIM signatures.
    domainSigningSelector String
    [Bring Your Own DKIM] Selector added to the DNS configuration for the domain.
    lastKeyGenerationTimestamp String
    [Easy DKIM] The last time a key pair was generated for this identity.
    nextSigningKeyLength String
    [Easy DKIM] The key length of the future DKIM key pair to be generated. This can be changed at most once per day.
    signingAttributesOrigin String
    String that indicates how DKIM was configured for the identity. AWS_SES indicates that DKIM was configured for the identity by using Easy DKIM. EXTERNAL indicates that DKIM was configured for the identity by using Bring Your Own DKIM (BYODKIM).
    status String
    Whether or not Amazon SES has successfully located the DKIM records in the DNS records for the domain. See the AWS SES API v2 Reference for supported statuses.
    tokens List<String>
    If you used Easy DKIM to configure DKIM authentication for the domain, then this object contains a set of unique strings that you use to create a set of CNAME records that you add to the DNS configuration for your domain. When Amazon SES detects these records in the DNS configuration for your domain, the DKIM authentication process is complete. If you configured DKIM authentication for the domain by providing your own public-private key pair, then this object contains the selector for the public key.
    currentSigningKeyLength string
    [Easy DKIM] The key length of the DKIM key pair in use.
    domainSigningPrivateKey string
    [Bring Your Own DKIM] Private key used to generate DKIM signatures.
    domainSigningSelector string
    [Bring Your Own DKIM] Selector added to the DNS configuration for the domain.
    lastKeyGenerationTimestamp string
    [Easy DKIM] The last time a key pair was generated for this identity.
    nextSigningKeyLength string
    [Easy DKIM] The key length of the future DKIM key pair to be generated. This can be changed at most once per day.
    signingAttributesOrigin string
    String that indicates how DKIM was configured for the identity. AWS_SES indicates that DKIM was configured for the identity by using Easy DKIM. EXTERNAL indicates that DKIM was configured for the identity by using Bring Your Own DKIM (BYODKIM).
    status string
    Whether or not Amazon SES has successfully located the DKIM records in the DNS records for the domain. See the AWS SES API v2 Reference for supported statuses.
    tokens string[]
    If you used Easy DKIM to configure DKIM authentication for the domain, then this object contains a set of unique strings that you use to create a set of CNAME records that you add to the DNS configuration for your domain. When Amazon SES detects these records in the DNS configuration for your domain, the DKIM authentication process is complete. If you configured DKIM authentication for the domain by providing your own public-private key pair, then this object contains the selector for the public key.
    current_signing_key_length str
    [Easy DKIM] The key length of the DKIM key pair in use.
    domain_signing_private_key str
    [Bring Your Own DKIM] Private key used to generate DKIM signatures.
    domain_signing_selector str
    [Bring Your Own DKIM] Selector added to the DNS configuration for the domain.
    last_key_generation_timestamp str
    [Easy DKIM] The last time a key pair was generated for this identity.
    next_signing_key_length str
    [Easy DKIM] The key length of the future DKIM key pair to be generated. This can be changed at most once per day.
    signing_attributes_origin str
    String that indicates how DKIM was configured for the identity. AWS_SES indicates that DKIM was configured for the identity by using Easy DKIM. EXTERNAL indicates that DKIM was configured for the identity by using Bring Your Own DKIM (BYODKIM).
    status str
    Whether or not Amazon SES has successfully located the DKIM records in the DNS records for the domain. See the AWS SES API v2 Reference for supported statuses.
    tokens Sequence[str]
    If you used Easy DKIM to configure DKIM authentication for the domain, then this object contains a set of unique strings that you use to create a set of CNAME records that you add to the DNS configuration for your domain. When Amazon SES detects these records in the DNS configuration for your domain, the DKIM authentication process is complete. If you configured DKIM authentication for the domain by providing your own public-private key pair, then this object contains the selector for the public key.
    currentSigningKeyLength String
    [Easy DKIM] The key length of the DKIM key pair in use.
    domainSigningPrivateKey String
    [Bring Your Own DKIM] Private key used to generate DKIM signatures.
    domainSigningSelector String
    [Bring Your Own DKIM] Selector added to the DNS configuration for the domain.
    lastKeyGenerationTimestamp String
    [Easy DKIM] The last time a key pair was generated for this identity.
    nextSigningKeyLength String
    [Easy DKIM] The key length of the future DKIM key pair to be generated. This can be changed at most once per day.
    signingAttributesOrigin String
    String that indicates how DKIM was configured for the identity. AWS_SES indicates that DKIM was configured for the identity by using Easy DKIM. EXTERNAL indicates that DKIM was configured for the identity by using Bring Your Own DKIM (BYODKIM).
    status String
    Whether or not Amazon SES has successfully located the DKIM records in the DNS records for the domain. See the AWS SES API v2 Reference for supported statuses.
    tokens List<String>
    If you used Easy DKIM to configure DKIM authentication for the domain, then this object contains a set of unique strings that you use to create a set of CNAME records that you add to the DNS configuration for your domain. When Amazon SES detects these records in the DNS configuration for your domain, the DKIM authentication process is complete. If you configured DKIM authentication for the domain by providing your own public-private key pair, then this object contains the selector for the public key.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo aws logo
    Viewing docs for AWS v7.46.0
    published on Thursday, Sep 10, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial