Amazon Simple Email Service
API Reference (API Version 2010-12-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

GetIdentityDkimAttributes

Description

Returns the current status of Easy DKIM signing for an entity. For domain name identities, this action also returns the DKIM tokens that are required for Easy DKIM signing, and whether Amazon SES has successfully verified that these tokens have been published.

This action takes a list of identities as input and returns the following information for each:

  • Whether Easy DKIM signing is enabled or disabled.
  • A set of DKIM tokens that represent the identity. If the identity is an email address, the tokens represent the domain of that address.
  • Whether Amazon SES has successfully verified the DKIM tokens published in the domain's DNS. This information is only returned for domain name identities, not for email addresses.

This action is throttled at one request per second.

For more information about creating DNS records using DKIM tokens, go to the Amazon SES Developer Guide.

Request Parameters

For information about the common parameters that all actions use, see Common Parameters.

Identities.member.N

A list of one or more verified identities - email addresses, domains, or both.

Type: String list

Required: Yes

Response Elements

The following element is returned in a GetIdentityDkimAttributesResult structure.

DkimAttributes

The DKIM attributes for an email address or a domain.

Type: String to IdentityDkimAttributes map

Examples

Sample Request

                
POST / HTTP/1.1
Date: Fri, 29 Jun 2012 22:41:32 GMT
Host: email.us-east-1.amazonaws.com
Content-Type: application/x-www-form-urlencoded
X-Amzn-Authorization: AWS3 AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE, 
 Signature=MJdhrIAt3c4BRC6jdzueMM+AJLEx17bnIHjZwlSenyk=, 
 Algorithm=HmacSHA256, SignedHeaders=Date;Host
Content-Length: 165

AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE
&Action=GetIdentityDkimAttributes
&Identities.member.1=example.com
&Timestamp=2012-06-29T22%3A41%3A32.000Z
&Version=2010-12-01
          
            

Sample Response

                
<GetIdentityDkimAttributesResponse xmlns="http://ses.amazonaws.com/doc/2010-12-01/">
  <GetIdentityDkimAttributesResult>
    <DkimAttributes>
      <entry>
        <key>amazon.com</key>
      <value>
        <DkimEnabled>true</DkimEnabled>
        <DkimVerificationStatus>Success</DkimVerificationStatus>
        <DkimTokens>
          <member>vvjuipp74whm76gqoni7qmwwn4w4qusjiainivf6f</member>
          <member>3frqe7jn4obpuxjpwpolz6ipb3k5nvt2nhjpik2oy</member>
          <member>wrqplteh7oodxnad7hsl4mixg2uavzneazxv5sxi2</member>
        </DkimTokens>
      </value>
    </entry>
    </DkimAttributes>
  </GetIdentityDkimAttributesResult>
  <ResponseMetadata>
    <RequestId>bb5a105d-c468-11e1-82eb-dff885ccc06a</RequestId>
  </ResponseMetadata>
</GetIdentityDkimAttributesResponse>