All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.amazonaws.services.simpleemail.AmazonSimpleEmailServiceAsync Maven / Gradle / Ivy

The newest version!
/*
 * Copyright 2010-2016 Amazon.com, Inc. or its affiliates. All Rights Reserved.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License").
 * You may not use this file except in compliance with the License.
 * A copy of the License is located at
 * 
 *  http://aws.amazon.com/apache2.0
 * 
 * or in the "license" file accompanying this file. This file is distributed
 * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
 * express or implied. See the License for the specific language governing
 * permissions and limitations under the License.
 */
package com.amazonaws.services.simpleemail;

import java.util.concurrent.Future;

import com.amazonaws.AmazonClientException;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.handlers.AsyncHandler;
import com.amazonaws.services.simpleemail.model.*;

/**
 * Interface for accessing AmazonSimpleEmailService asynchronously.
 * Each asynchronous method will return a Java Future object, and users are also allowed
 * to provide a callback handler.
 * Amazon Simple Email Service 

* This is the API Reference for Amazon Simple Email Service (Amazon * SES). This documentation is intended to be used in conjunction with * the * Amazon SES Developer Guide * . *

*

* NOTE:For a list of Amazon SES endpoints to use in service * requests, see Regions and Amazon SES in the Amazon SES Developer * Guide. *

*/ public interface AmazonSimpleEmailServiceAsync extends AmazonSimpleEmailService { /** *

* Returns the user's current sending limits. *

*

* This action is throttled at one request per second. *

* * @param getSendQuotaRequest Container for the necessary parameters to * execute the GetSendQuota operation on AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * GetSendQuota service method, as returned by AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future getSendQuotaAsync(GetSendQuotaRequest getSendQuotaRequest) throws AmazonServiceException, AmazonClientException; /** *

* Returns the user's current sending limits. *

*

* This action is throttled at one request per second. *

* * @param getSendQuotaRequest Container for the necessary parameters to * execute the GetSendQuota operation on AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * GetSendQuota service method, as returned by AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future getSendQuotaAsync(GetSendQuotaRequest getSendQuotaRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Sets the position of the specified receipt rule in the receipt rule * set. *

*

* For information about managing receipt rules, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param setReceiptRulePositionRequest Container for the necessary * parameters to execute the SetReceiptRulePosition operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * SetReceiptRulePosition service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future setReceiptRulePositionAsync(SetReceiptRulePositionRequest setReceiptRulePositionRequest) throws AmazonServiceException, AmazonClientException; /** *

* Sets the position of the specified receipt rule in the receipt rule * set. *

*

* For information about managing receipt rules, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param setReceiptRulePositionRequest Container for the necessary * parameters to execute the SetReceiptRulePosition operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * SetReceiptRulePosition service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future setReceiptRulePositionAsync(SetReceiptRulePositionRequest setReceiptRulePositionRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified identity (email address or domain) from the * list of verified identities. *

*

* This action is throttled at one request per second. *

* * @param deleteIdentityRequest Container for the necessary parameters to * execute the DeleteIdentity operation on AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * DeleteIdentity service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteIdentityAsync(DeleteIdentityRequest deleteIdentityRequest) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified identity (email address or domain) from the * list of verified identities. *

*

* This action is throttled at one request per second. *

* * @param deleteIdentityRequest Container for the necessary parameters to * execute the DeleteIdentity operation on AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DeleteIdentity service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteIdentityAsync(DeleteIdentityRequest deleteIdentityRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Enables or disables Easy DKIM signing of email sent from an identity: *

* *
    *
  • If Easy DKIM signing is enabled for a domain name identity (e.g., * example.com ), then Amazon SES will DKIM-sign all email * sent by addresses under that domain name (e.g., * [email protected] ).
  • *
  • If Easy DKIM signing is enabled for an email address, then Amazon * SES will DKIM-sign all email sent by that email address.
  • * *
*

* For email addresses (e.g., [email protected] ), you can * only enable Easy DKIM signing if the corresponding domain (e.g., * example.com ) has been set up for Easy DKIM using the AWS * Console or the VerifyDomainDkim action. *

*

* This action is throttled at one request per second. *

*

* For more information about Easy DKIM signing, go to the * Amazon SES Developer Guide * . *

* * @param setIdentityDkimEnabledRequest Container for the necessary * parameters to execute the SetIdentityDkimEnabled operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * SetIdentityDkimEnabled service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future setIdentityDkimEnabledAsync(SetIdentityDkimEnabledRequest setIdentityDkimEnabledRequest) throws AmazonServiceException, AmazonClientException; /** *

* Enables or disables Easy DKIM signing of email sent from an identity: *

* *
    *
  • If Easy DKIM signing is enabled for a domain name identity (e.g., * example.com ), then Amazon SES will DKIM-sign all email * sent by addresses under that domain name (e.g., * [email protected] ).
  • *
  • If Easy DKIM signing is enabled for an email address, then Amazon * SES will DKIM-sign all email sent by that email address.
  • * *
*

* For email addresses (e.g., [email protected] ), you can * only enable Easy DKIM signing if the corresponding domain (e.g., * example.com ) has been set up for Easy DKIM using the AWS * Console or the VerifyDomainDkim action. *

*

* This action is throttled at one request per second. *

*

* For more information about Easy DKIM signing, go to the * Amazon SES Developer Guide * . *

* * @param setIdentityDkimEnabledRequest Container for the necessary * parameters to execute the SetIdentityDkimEnabled operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * SetIdentityDkimEnabled service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future setIdentityDkimEnabledAsync(SetIdentityDkimEnabledRequest setIdentityDkimEnabledRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Creates a receipt rule set by cloning an existing one. All receipt * rules and configurations are copied to the new receipt rule set and * are completely independent of the source rule set. *

*

* For information about setting up rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param cloneReceiptRuleSetRequest Container for the necessary * parameters to execute the CloneReceiptRuleSet operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * CloneReceiptRuleSet service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future cloneReceiptRuleSetAsync(CloneReceiptRuleSetRequest cloneReceiptRuleSetRequest) throws AmazonServiceException, AmazonClientException; /** *

* Creates a receipt rule set by cloning an existing one. All receipt * rules and configurations are copied to the new receipt rule set and * are completely independent of the source rule set. *

*

* For information about setting up rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param cloneReceiptRuleSetRequest Container for the necessary * parameters to execute the CloneReceiptRuleSet operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * CloneReceiptRuleSet service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future cloneReceiptRuleSetAsync(CloneReceiptRuleSetRequest cloneReceiptRuleSetRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* 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 and can only get * DKIM attributes for up to 100 identities at a time. *

*

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

* * @param getIdentityDkimAttributesRequest Container for the necessary * parameters to execute the GetIdentityDkimAttributes operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * GetIdentityDkimAttributes service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future getIdentityDkimAttributesAsync(GetIdentityDkimAttributesRequest getIdentityDkimAttributesRequest) throws AmazonServiceException, AmazonClientException; /** *

* 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 and can only get * DKIM attributes for up to 100 identities at a time. *

*

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

* * @param getIdentityDkimAttributesRequest Container for the necessary * parameters to execute the GetIdentityDkimAttributes operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * GetIdentityDkimAttributes service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future getIdentityDkimAttributesAsync(GetIdentityDkimAttributesRequest getIdentityDkimAttributesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Returns the requested sending authorization policies for the given * identity (email address or domain). The policies are returned as a map * of policy names to policy contents. You can retrieve a maximum of 20 * policies at a time. *

*

* NOTE:This API is for the identity owner only. If you have not * verified the identity, this API will return an error. *

*

* Sending authorization is a feature that enables an identity owner to * authorize other senders to use its identities. For information about * using sending authorization, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param getIdentityPoliciesRequest Container for the necessary * parameters to execute the GetIdentityPolicies operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * GetIdentityPolicies service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future getIdentityPoliciesAsync(GetIdentityPoliciesRequest getIdentityPoliciesRequest) throws AmazonServiceException, AmazonClientException; /** *

* Returns the requested sending authorization policies for the given * identity (email address or domain). The policies are returned as a map * of policy names to policy contents. You can retrieve a maximum of 20 * policies at a time. *

*

* NOTE:This API is for the identity owner only. If you have not * verified the identity, this API will return an error. *

*

* Sending authorization is a feature that enables an identity owner to * authorize other senders to use its identities. For information about * using sending authorization, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param getIdentityPoliciesRequest Container for the necessary * parameters to execute the GetIdentityPolicies operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * GetIdentityPolicies service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future getIdentityPoliciesAsync(GetIdentityPoliciesRequest getIdentityPoliciesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Returns a list of sending authorization policies that are attached to * the given identity (email address or domain). This API returns only a * list. If you want the actual policy content, you can use * GetIdentityPolicies . *

*

* NOTE:This API is for the identity owner only. If you have not * verified the identity, this API will return an error. *

*

* Sending authorization is a feature that enables an identity owner to * authorize other senders to use its identities. For information about * using sending authorization, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param listIdentityPoliciesRequest Container for the necessary * parameters to execute the ListIdentityPolicies operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * ListIdentityPolicies service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future listIdentityPoliciesAsync(ListIdentityPoliciesRequest listIdentityPoliciesRequest) throws AmazonServiceException, AmazonClientException; /** *

* Returns a list of sending authorization policies that are attached to * the given identity (email address or domain). This API returns only a * list. If you want the actual policy content, you can use * GetIdentityPolicies . *

*

* NOTE:This API is for the identity owner only. If you have not * verified the identity, this API will return an error. *

*

* Sending authorization is a feature that enables an identity owner to * authorize other senders to use its identities. For information about * using sending authorization, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param listIdentityPoliciesRequest Container for the necessary * parameters to execute the ListIdentityPolicies operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ListIdentityPolicies service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future listIdentityPoliciesAsync(ListIdentityPoliciesRequest listIdentityPoliciesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Returns the custom MAIL FROM attributes for a list of identities * (email addresses and/or domains). *

*

* This action is throttled at one request per second and can only get * custom MAIL FROM attributes for up to 100 identities at a time. *

* * @param getIdentityMailFromDomainAttributesRequest Container for the * necessary parameters to execute the * GetIdentityMailFromDomainAttributes operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * GetIdentityMailFromDomainAttributes service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future getIdentityMailFromDomainAttributesAsync(GetIdentityMailFromDomainAttributesRequest getIdentityMailFromDomainAttributesRequest) throws AmazonServiceException, AmazonClientException; /** *

* Returns the custom MAIL FROM attributes for a list of identities * (email addresses and/or domains). *

*

* This action is throttled at one request per second and can only get * custom MAIL FROM attributes for up to 100 identities at a time. *

* * @param getIdentityMailFromDomainAttributesRequest Container for the * necessary parameters to execute the * GetIdentityMailFromDomainAttributes operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * GetIdentityMailFromDomainAttributes service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future getIdentityMailFromDomainAttributesAsync(GetIdentityMailFromDomainAttributesRequest getIdentityMailFromDomainAttributesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Lists the receipt rule sets that exist under your AWS account. If * there are additional receipt rule sets to be retrieved, you will * receive a NextToken that you can provide to the next call * to ListReceiptRuleSets to retrieve the additional * entries. *

*

* For information about managing receipt rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param listReceiptRuleSetsRequest Container for the necessary * parameters to execute the ListReceiptRuleSets operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * ListReceiptRuleSets service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future listReceiptRuleSetsAsync(ListReceiptRuleSetsRequest listReceiptRuleSetsRequest) throws AmazonServiceException, AmazonClientException; /** *

* Lists the receipt rule sets that exist under your AWS account. If * there are additional receipt rule sets to be retrieved, you will * receive a NextToken that you can provide to the next call * to ListReceiptRuleSets to retrieve the additional * entries. *

*

* For information about managing receipt rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param listReceiptRuleSetsRequest Container for the necessary * parameters to execute the ListReceiptRuleSets operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ListReceiptRuleSets service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future listReceiptRuleSetsAsync(ListReceiptRuleSetsRequest listReceiptRuleSetsRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Lists the IP address filters associated with your account. *

*

* For information about managing IP address filters, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param listReceiptFiltersRequest Container for the necessary * parameters to execute the ListReceiptFilters operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * ListReceiptFilters service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future listReceiptFiltersAsync(ListReceiptFiltersRequest listReceiptFiltersRequest) throws AmazonServiceException, AmazonClientException; /** *

* Lists the IP address filters associated with your account. *

*

* For information about managing IP address filters, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param listReceiptFiltersRequest Container for the necessary * parameters to execute the ListReceiptFilters operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ListReceiptFilters service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future listReceiptFiltersAsync(ListReceiptFiltersRequest listReceiptFiltersRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Creates a new IP address filter. *

*

* For information about setting up IP address filters, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param createReceiptFilterRequest Container for the necessary * parameters to execute the CreateReceiptFilter operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * CreateReceiptFilter service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future createReceiptFilterAsync(CreateReceiptFilterRequest createReceiptFilterRequest) throws AmazonServiceException, AmazonClientException; /** *

* Creates a new IP address filter. *

*

* For information about setting up IP address filters, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param createReceiptFilterRequest Container for the necessary * parameters to execute the CreateReceiptFilter operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * CreateReceiptFilter service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future createReceiptFilterAsync(CreateReceiptFilterRequest createReceiptFilterRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified email address from the list of verified * addresses. *

*

* IMPORTANT:The DeleteVerifiedEmailAddress action is deprecated * as of the May 15, 2012 release of Domain Verification. The * DeleteIdentity action is now preferred. *

*

* This action is throttled at one request per second. *

* * @param deleteVerifiedEmailAddressRequest Container for the necessary * parameters to execute the DeleteVerifiedEmailAddress operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * DeleteVerifiedEmailAddress service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteVerifiedEmailAddressAsync(DeleteVerifiedEmailAddressRequest deleteVerifiedEmailAddressRequest) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified email address from the list of verified * addresses. *

*

* IMPORTANT:The DeleteVerifiedEmailAddress action is deprecated * as of the May 15, 2012 release of Domain Verification. The * DeleteIdentity action is now preferred. *

*

* This action is throttled at one request per second. *

* * @param deleteVerifiedEmailAddressRequest Container for the necessary * parameters to execute the DeleteVerifiedEmailAddress operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DeleteVerifiedEmailAddress service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteVerifiedEmailAddressAsync(DeleteVerifiedEmailAddressRequest deleteVerifiedEmailAddressRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Verifies a domain. *

*

* This action is throttled at one request per second. *

* * @param verifyDomainIdentityRequest Container for the necessary * parameters to execute the VerifyDomainIdentity operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * VerifyDomainIdentity service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future verifyDomainIdentityAsync(VerifyDomainIdentityRequest verifyDomainIdentityRequest) throws AmazonServiceException, AmazonClientException; /** *

* Verifies a domain. *

*

* This action is throttled at one request per second. *

* * @param verifyDomainIdentityRequest Container for the necessary * parameters to execute the VerifyDomainIdentity operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * VerifyDomainIdentity service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future verifyDomainIdentityAsync(VerifyDomainIdentityRequest verifyDomainIdentityRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Enables or disables the custom MAIL FROM domain setup for a verified * identity (email address or domain). *

*

* IMPORTANT:To send emails using the specified MAIL FROM domain, * you must add an MX record to your MAIL FROM domain's DNS settings. If * you want your emails to pass Sender Policy Framework (SPF) checks, you * must also add or update an SPF record. For more information, see the * Amazon SES Developer Guide. *

*

* This action is throttled at one request per second. *

* * @param setIdentityMailFromDomainRequest Container for the necessary * parameters to execute the SetIdentityMailFromDomain operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * SetIdentityMailFromDomain service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future setIdentityMailFromDomainAsync(SetIdentityMailFromDomainRequest setIdentityMailFromDomainRequest) throws AmazonServiceException, AmazonClientException; /** *

* Enables or disables the custom MAIL FROM domain setup for a verified * identity (email address or domain). *

*

* IMPORTANT:To send emails using the specified MAIL FROM domain, * you must add an MX record to your MAIL FROM domain's DNS settings. If * you want your emails to pass Sender Policy Framework (SPF) checks, you * must also add or update an SPF record. For more information, see the * Amazon SES Developer Guide. *

*

* This action is throttled at one request per second. *

* * @param setIdentityMailFromDomainRequest Container for the necessary * parameters to execute the SetIdentityMailFromDomain operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * SetIdentityMailFromDomain service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future setIdentityMailFromDomainAsync(SetIdentityMailFromDomainRequest setIdentityMailFromDomainRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Reorders the receipt rules within a receipt rule set. *

*

* NOTE:All of the rules in the rule set must be represented in * this request. That is, this API will return an error if the reorder * request doesn't explicitly position all of the rules. *

*

* For information about managing receipt rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param reorderReceiptRuleSetRequest Container for the necessary * parameters to execute the ReorderReceiptRuleSet operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * ReorderReceiptRuleSet service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future reorderReceiptRuleSetAsync(ReorderReceiptRuleSetRequest reorderReceiptRuleSetRequest) throws AmazonServiceException, AmazonClientException; /** *

* Reorders the receipt rules within a receipt rule set. *

*

* NOTE:All of the rules in the rule set must be represented in * this request. That is, this API will return an error if the reorder * request doesn't explicitly position all of the rules. *

*

* For information about managing receipt rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param reorderReceiptRuleSetRequest Container for the necessary * parameters to execute the ReorderReceiptRuleSet operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ReorderReceiptRuleSet service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future reorderReceiptRuleSetAsync(ReorderReceiptRuleSetRequest reorderReceiptRuleSetRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Updates a receipt rule. *

*

* For information about managing receipt rules, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param updateReceiptRuleRequest Container for the necessary parameters * to execute the UpdateReceiptRule operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * UpdateReceiptRule service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future updateReceiptRuleAsync(UpdateReceiptRuleRequest updateReceiptRuleRequest) throws AmazonServiceException, AmazonClientException; /** *

* Updates a receipt rule. *

*

* For information about managing receipt rules, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param updateReceiptRuleRequest Container for the necessary parameters * to execute the UpdateReceiptRule operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * UpdateReceiptRule service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future updateReceiptRuleAsync(UpdateReceiptRuleRequest updateReceiptRuleRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Sends an email message, with header and content specified by the * client. The SendRawEmail action is useful for sending * multipart MIME emails. The raw text of the message must comply with * Internet email standards; otherwise, the message cannot be sent. *

*

* There are several important points to know about * SendRawEmail : *

* *
    *
  • You can only send email from verified email addresses and * domains; otherwise, you will get an "Email address not verified" * error. If your account is still in the Amazon SES sandbox, you must * also verify every recipient email address except for the recipients * provided by the Amazon SES mailbox simulator. For more information, go * to the * Amazon SES Developer Guide * .
  • *
  • The total size of the message cannot exceed 10 MB. This includes * any attachments that are part of the message.
  • *
  • Amazon SES has a limit on the total number of recipients per * message. The combined number of To:, CC: and BCC: email addresses * cannot exceed 50. If you need to send an email message to a larger * audience, you can divide your recipient list into groups of 50 or * fewer, and then call Amazon SES repeatedly to send the message to each * group.
  • *
  • The To:, CC:, and BCC: headers in the raw message can contain a * group list. Note that each recipient in a group list counts towards * the 50-recipient limit.
  • *
  • For every message that you send, the total number of recipients * (To:, CC: and BCC:) is counted against your sending quota - the * maximum number of emails you can send in a 24-hour period. For * information about your sending quota, go to the * Amazon SES Developer Guide * .
  • *
  • If you are using sending authorization to send on behalf of * another user, SendRawEmail enables you to specify the * cross-account identity for the email's "Source," "From," and * "Return-Path" parameters in one of two ways: you can pass optional * parameters SourceArn , FromArn , and/or * ReturnPathArn to the API, or you can include the * following X-headers in the header of your raw email: *
      *
    • X-SES-SOURCE-ARN
    • *
    • X-SES-FROM-ARN
    • *
    • X-SES-RETURN-PATH-ARN
    • * *
    *

    * IMPORTANT:Do not include these X-headers in the DKIM * signature, because they are removed by Amazon SES before sending the * email. *

    * For the most common sending authorization use case, we recommend that * you specify the SourceIdentityArn and do not specify * either the FromIdentityArn or * ReturnPathIdentityArn . (The same note applies to the * corresponding X-headers.) If you only specify the * SourceIdentityArn , Amazon SES will simply set the "From" * address and the "Return Path" address to the identity specified in * SourceIdentityArn . For more information about sending * authorization, see the * Amazon SES Developer Guide * .
  • * *
* * @param sendRawEmailRequest Container for the necessary parameters to * execute the SendRawEmail operation on AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * SendRawEmail service method, as returned by AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future sendRawEmailAsync(SendRawEmailRequest sendRawEmailRequest) throws AmazonServiceException, AmazonClientException; /** *

* Sends an email message, with header and content specified by the * client. The SendRawEmail action is useful for sending * multipart MIME emails. The raw text of the message must comply with * Internet email standards; otherwise, the message cannot be sent. *

*

* There are several important points to know about * SendRawEmail : *

* *
    *
  • You can only send email from verified email addresses and * domains; otherwise, you will get an "Email address not verified" * error. If your account is still in the Amazon SES sandbox, you must * also verify every recipient email address except for the recipients * provided by the Amazon SES mailbox simulator. For more information, go * to the * Amazon SES Developer Guide * .
  • *
  • The total size of the message cannot exceed 10 MB. This includes * any attachments that are part of the message.
  • *
  • Amazon SES has a limit on the total number of recipients per * message. The combined number of To:, CC: and BCC: email addresses * cannot exceed 50. If you need to send an email message to a larger * audience, you can divide your recipient list into groups of 50 or * fewer, and then call Amazon SES repeatedly to send the message to each * group.
  • *
  • The To:, CC:, and BCC: headers in the raw message can contain a * group list. Note that each recipient in a group list counts towards * the 50-recipient limit.
  • *
  • For every message that you send, the total number of recipients * (To:, CC: and BCC:) is counted against your sending quota - the * maximum number of emails you can send in a 24-hour period. For * information about your sending quota, go to the * Amazon SES Developer Guide * .
  • *
  • If you are using sending authorization to send on behalf of * another user, SendRawEmail enables you to specify the * cross-account identity for the email's "Source," "From," and * "Return-Path" parameters in one of two ways: you can pass optional * parameters SourceArn , FromArn , and/or * ReturnPathArn to the API, or you can include the * following X-headers in the header of your raw email: *
      *
    • X-SES-SOURCE-ARN
    • *
    • X-SES-FROM-ARN
    • *
    • X-SES-RETURN-PATH-ARN
    • * *
    *

    * IMPORTANT:Do not include these X-headers in the DKIM * signature, because they are removed by Amazon SES before sending the * email. *

    * For the most common sending authorization use case, we recommend that * you specify the SourceIdentityArn and do not specify * either the FromIdentityArn or * ReturnPathIdentityArn . (The same note applies to the * corresponding X-headers.) If you only specify the * SourceIdentityArn , Amazon SES will simply set the "From" * address and the "Return Path" address to the identity specified in * SourceIdentityArn . For more information about sending * authorization, see the * Amazon SES Developer Guide * .
  • * *
* * @param sendRawEmailRequest Container for the necessary parameters to * execute the SendRawEmail operation on AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * SendRawEmail service method, as returned by AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future sendRawEmailAsync(SendRawEmailRequest sendRawEmailRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Given a list of identities (email addresses and/or domains), returns * the verification status and (for domain identities) the verification * token for each identity. *

*

* This action is throttled at one request per second and can only get * verification attributes for up to 100 identities at a time. *

* * @param getIdentityVerificationAttributesRequest Container for the * necessary parameters to execute the GetIdentityVerificationAttributes * operation on AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * GetIdentityVerificationAttributes service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future getIdentityVerificationAttributesAsync(GetIdentityVerificationAttributesRequest getIdentityVerificationAttributesRequest) throws AmazonServiceException, AmazonClientException; /** *

* Given a list of identities (email addresses and/or domains), returns * the verification status and (for domain identities) the verification * token for each identity. *

*

* This action is throttled at one request per second and can only get * verification attributes for up to 100 identities at a time. *

* * @param getIdentityVerificationAttributesRequest Container for the * necessary parameters to execute the GetIdentityVerificationAttributes * operation on AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * GetIdentityVerificationAttributes service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future getIdentityVerificationAttributesAsync(GetIdentityVerificationAttributesRequest getIdentityVerificationAttributesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified receipt rule. *

*

* For information about managing receipt rules, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param deleteReceiptRuleRequest Container for the necessary parameters * to execute the DeleteReceiptRule operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * DeleteReceiptRule service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteReceiptRuleAsync(DeleteReceiptRuleRequest deleteReceiptRuleRequest) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified receipt rule. *

*

* For information about managing receipt rules, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param deleteReceiptRuleRequest Container for the necessary parameters * to execute the DeleteReceiptRule operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DeleteReceiptRule service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteReceiptRuleAsync(DeleteReceiptRuleRequest deleteReceiptRuleRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified receipt rule set and all of the receipt rules * it contains. *

*

* NOTE:The currently active rule set cannot be deleted. *

*

* For information about managing receipt rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param deleteReceiptRuleSetRequest Container for the necessary * parameters to execute the DeleteReceiptRuleSet operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * DeleteReceiptRuleSet service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteReceiptRuleSetAsync(DeleteReceiptRuleSetRequest deleteReceiptRuleSetRequest) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified receipt rule set and all of the receipt rules * it contains. *

*

* NOTE:The currently active rule set cannot be deleted. *

*

* For information about managing receipt rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param deleteReceiptRuleSetRequest Container for the necessary * parameters to execute the DeleteReceiptRuleSet operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DeleteReceiptRuleSet service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteReceiptRuleSetAsync(DeleteReceiptRuleSetRequest deleteReceiptRuleSetRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Given an identity (email address or domain), sets the Amazon Simple * Notification Service (Amazon SNS) topic to which Amazon SES will * publish bounce, complaint, and/or delivery notifications for emails * sent with that identity as the Source . *

*

* NOTE:Unless feedback forwarding is enabled, you must specify * Amazon SNS topics for bounce and complaint notifications. For more * information, see SetIdentityFeedbackForwardingEnabled. *

*

* This action is throttled at one request per second. *

*

* For more information about feedback notification, see the * Amazon SES Developer Guide * . *

* * @param setIdentityNotificationTopicRequest Container for the necessary * parameters to execute the SetIdentityNotificationTopic operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * SetIdentityNotificationTopic service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future setIdentityNotificationTopicAsync(SetIdentityNotificationTopicRequest setIdentityNotificationTopicRequest) throws AmazonServiceException, AmazonClientException; /** *

* Given an identity (email address or domain), sets the Amazon Simple * Notification Service (Amazon SNS) topic to which Amazon SES will * publish bounce, complaint, and/or delivery notifications for emails * sent with that identity as the Source . *

*

* NOTE:Unless feedback forwarding is enabled, you must specify * Amazon SNS topics for bounce and complaint notifications. For more * information, see SetIdentityFeedbackForwardingEnabled. *

*

* This action is throttled at one request per second. *

*

* For more information about feedback notification, see the * Amazon SES Developer Guide * . *

* * @param setIdentityNotificationTopicRequest Container for the necessary * parameters to execute the SetIdentityNotificationTopic operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * SetIdentityNotificationTopic service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future setIdentityNotificationTopicAsync(SetIdentityNotificationTopicRequest setIdentityNotificationTopicRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Creates a receipt rule. *

*

* For information about setting up receipt rules, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param createReceiptRuleRequest Container for the necessary parameters * to execute the CreateReceiptRule operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * CreateReceiptRule service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future createReceiptRuleAsync(CreateReceiptRuleRequest createReceiptRuleRequest) throws AmazonServiceException, AmazonClientException; /** *

* Creates a receipt rule. *

*

* For information about setting up receipt rules, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param createReceiptRuleRequest Container for the necessary parameters * to execute the CreateReceiptRule operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * CreateReceiptRule service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future createReceiptRuleAsync(CreateReceiptRuleRequest createReceiptRuleRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Sets the specified receipt rule set as the active receipt rule set. *

*

* NOTE:To disable your email-receiving through Amazon SES * completely, you can call this API with RuleSetName set to null. *

*

* For information about managing receipt rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param setActiveReceiptRuleSetRequest Container for the necessary * parameters to execute the SetActiveReceiptRuleSet operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * SetActiveReceiptRuleSet service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future setActiveReceiptRuleSetAsync(SetActiveReceiptRuleSetRequest setActiveReceiptRuleSetRequest) throws AmazonServiceException, AmazonClientException; /** *

* Sets the specified receipt rule set as the active receipt rule set. *

*

* NOTE:To disable your email-receiving through Amazon SES * completely, you can call this API with RuleSetName set to null. *

*

* For information about managing receipt rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param setActiveReceiptRuleSetRequest Container for the necessary * parameters to execute the SetActiveReceiptRuleSet operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * SetActiveReceiptRuleSet service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future setActiveReceiptRuleSetAsync(SetActiveReceiptRuleSetRequest setActiveReceiptRuleSetRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified IP address filter. *

*

* For information about managing IP address filters, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param deleteReceiptFilterRequest Container for the necessary * parameters to execute the DeleteReceiptFilter operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * DeleteReceiptFilter service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteReceiptFilterAsync(DeleteReceiptFilterRequest deleteReceiptFilterRequest) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified IP address filter. *

*

* For information about managing IP address filters, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param deleteReceiptFilterRequest Container for the necessary * parameters to execute the DeleteReceiptFilter operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DeleteReceiptFilter service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteReceiptFilterAsync(DeleteReceiptFilterRequest deleteReceiptFilterRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Returns the details of the specified receipt rule set. *

*

* For information about managing receipt rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param describeReceiptRuleSetRequest Container for the necessary * parameters to execute the DescribeReceiptRuleSet operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * DescribeReceiptRuleSet service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future describeReceiptRuleSetAsync(DescribeReceiptRuleSetRequest describeReceiptRuleSetRequest) throws AmazonServiceException, AmazonClientException; /** *

* Returns the details of the specified receipt rule set. *

*

* For information about managing receipt rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param describeReceiptRuleSetRequest Container for the necessary * parameters to execute the DescribeReceiptRuleSet operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeReceiptRuleSet service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future describeReceiptRuleSetAsync(DescribeReceiptRuleSetRequest describeReceiptRuleSetRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Given an identity (email address or domain), enables or disables * whether Amazon SES forwards bounce and complaint notifications as * email. Feedback forwarding can only be disabled when Amazon Simple * Notification Service (Amazon SNS) topics are specified for both * bounces and complaints. *

*

* NOTE:Feedback forwarding does not apply to delivery * notifications. Delivery notifications are only available through * Amazon SNS. *

*

* This action is throttled at one request per second. *

*

* For more information about using notifications with Amazon SES, see * the * Amazon SES Developer Guide * . *

* * @param setIdentityFeedbackForwardingEnabledRequest Container for the * necessary parameters to execute the * SetIdentityFeedbackForwardingEnabled operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * SetIdentityFeedbackForwardingEnabled service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future setIdentityFeedbackForwardingEnabledAsync(SetIdentityFeedbackForwardingEnabledRequest setIdentityFeedbackForwardingEnabledRequest) throws AmazonServiceException, AmazonClientException; /** *

* Given an identity (email address or domain), enables or disables * whether Amazon SES forwards bounce and complaint notifications as * email. Feedback forwarding can only be disabled when Amazon Simple * Notification Service (Amazon SNS) topics are specified for both * bounces and complaints. *

*

* NOTE:Feedback forwarding does not apply to delivery * notifications. Delivery notifications are only available through * Amazon SNS. *

*

* This action is throttled at one request per second. *

*

* For more information about using notifications with Amazon SES, see * the * Amazon SES Developer Guide * . *

* * @param setIdentityFeedbackForwardingEnabledRequest Container for the * necessary parameters to execute the * SetIdentityFeedbackForwardingEnabled operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * SetIdentityFeedbackForwardingEnabled service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future setIdentityFeedbackForwardingEnabledAsync(SetIdentityFeedbackForwardingEnabledRequest setIdentityFeedbackForwardingEnabledRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Generates and sends a bounce message to the sender of an email you * received through Amazon SES. You can only use this API on an email up * to 24 hours after you receive it. *

*

* NOTE:You cannot use this API to send generic bounces for mail * that was not received by Amazon SES. *

*

* For information about receiving email through Amazon SES, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param sendBounceRequest Container for the necessary parameters to * execute the SendBounce operation on AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * SendBounce service method, as returned by AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future sendBounceAsync(SendBounceRequest sendBounceRequest) throws AmazonServiceException, AmazonClientException; /** *

* Generates and sends a bounce message to the sender of an email you * received through Amazon SES. You can only use this API on an email up * to 24 hours after you receive it. *

*

* NOTE:You cannot use this API to send generic bounces for mail * that was not received by Amazon SES. *

*

* For information about receiving email through Amazon SES, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param sendBounceRequest Container for the necessary parameters to * execute the SendBounce operation on AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * SendBounce service method, as returned by AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future sendBounceAsync(SendBounceRequest sendBounceRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Composes an email message based on input data, and then immediately * queues the message for sending. *

*

* There are several important points to know about * SendEmail : *

* *
    *
  • You can only send email from verified email addresses and * domains; otherwise, you will get an "Email address not verified" * error. If your account is still in the Amazon SES sandbox, you must * also verify every recipient email address except for the recipients * provided by the Amazon SES mailbox simulator. For more information, go * to the * Amazon SES Developer Guide * .
  • *
  • The total size of the message cannot exceed 10 MB. This includes * any attachments that are part of the message.
  • *
  • Amazon SES has a limit on the total number of recipients per * message. The combined number of To:, CC: and BCC: email addresses * cannot exceed 50. If you need to send an email message to a larger * audience, you can divide your recipient list into groups of 50 or * fewer, and then call Amazon SES repeatedly to send the message to each * group.
  • *
  • For every message that you send, the total number of recipients * (To:, CC: and BCC:) is counted against your sending quota - the * maximum number of emails you can send in a 24-hour period. For * information about your sending quota, go to the * Amazon SES Developer Guide * .
  • * *
* * @param sendEmailRequest Container for the necessary parameters to * execute the SendEmail operation on AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * SendEmail service method, as returned by AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future sendEmailAsync(SendEmailRequest sendEmailRequest) throws AmazonServiceException, AmazonClientException; /** *

* Composes an email message based on input data, and then immediately * queues the message for sending. *

*

* There are several important points to know about * SendEmail : *

* *
    *
  • You can only send email from verified email addresses and * domains; otherwise, you will get an "Email address not verified" * error. If your account is still in the Amazon SES sandbox, you must * also verify every recipient email address except for the recipients * provided by the Amazon SES mailbox simulator. For more information, go * to the * Amazon SES Developer Guide * .
  • *
  • The total size of the message cannot exceed 10 MB. This includes * any attachments that are part of the message.
  • *
  • Amazon SES has a limit on the total number of recipients per * message. The combined number of To:, CC: and BCC: email addresses * cannot exceed 50. If you need to send an email message to a larger * audience, you can divide your recipient list into groups of 50 or * fewer, and then call Amazon SES repeatedly to send the message to each * group.
  • *
  • For every message that you send, the total number of recipients * (To:, CC: and BCC:) is counted against your sending quota - the * maximum number of emails you can send in a 24-hour period. For * information about your sending quota, go to the * Amazon SES Developer Guide * .
  • * *
* * @param sendEmailRequest Container for the necessary parameters to * execute the SendEmail operation on AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * SendEmail service method, as returned by AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future sendEmailAsync(SendEmailRequest sendEmailRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Returns a list containing all of the identities (email addresses and * domains) for a specific AWS Account, regardless of verification * status. *

*

* This action is throttled at one request per second. *

* * @param listIdentitiesRequest Container for the necessary parameters to * execute the ListIdentities operation on AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * ListIdentities service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future listIdentitiesAsync(ListIdentitiesRequest listIdentitiesRequest) throws AmazonServiceException, AmazonClientException; /** *

* Returns a list containing all of the identities (email addresses and * domains) for a specific AWS Account, regardless of verification * status. *

*

* This action is throttled at one request per second. *

* * @param listIdentitiesRequest Container for the necessary parameters to * execute the ListIdentities operation on AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ListIdentities service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future listIdentitiesAsync(ListIdentitiesRequest listIdentitiesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Adds or updates a sending authorization policy for the specified * identity (email address or domain). *

*

* NOTE:This API is for the identity owner only. If you have not * verified the identity, this API will return an error. *

*

* Sending authorization is a feature that enables an identity owner to * authorize other senders to use its identities. For information about * using sending authorization, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param putIdentityPolicyRequest Container for the necessary parameters * to execute the PutIdentityPolicy operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * PutIdentityPolicy service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future putIdentityPolicyAsync(PutIdentityPolicyRequest putIdentityPolicyRequest) throws AmazonServiceException, AmazonClientException; /** *

* Adds or updates a sending authorization policy for the specified * identity (email address or domain). *

*

* NOTE:This API is for the identity owner only. If you have not * verified the identity, this API will return an error. *

*

* Sending authorization is a feature that enables an identity owner to * authorize other senders to use its identities. For information about * using sending authorization, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param putIdentityPolicyRequest Container for the necessary parameters * to execute the PutIdentityPolicy operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * PutIdentityPolicy service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future putIdentityPolicyAsync(PutIdentityPolicyRequest putIdentityPolicyRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Verifies an email address. This action causes a confirmation email * message to be sent to the specified address. *

*

* IMPORTANT:The VerifyEmailAddress action is deprecated as of * the May 15, 2012 release of Domain Verification. The * VerifyEmailIdentity action is now preferred. *

*

* This action is throttled at one request per second. *

* * @param verifyEmailAddressRequest Container for the necessary * parameters to execute the VerifyEmailAddress operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * VerifyEmailAddress service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future verifyEmailAddressAsync(VerifyEmailAddressRequest verifyEmailAddressRequest) throws AmazonServiceException, AmazonClientException; /** *

* Verifies an email address. This action causes a confirmation email * message to be sent to the specified address. *

*

* IMPORTANT:The VerifyEmailAddress action is deprecated as of * the May 15, 2012 release of Domain Verification. The * VerifyEmailIdentity action is now preferred. *

*

* This action is throttled at one request per second. *

* * @param verifyEmailAddressRequest Container for the necessary * parameters to execute the VerifyEmailAddress operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * VerifyEmailAddress service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future verifyEmailAddressAsync(VerifyEmailAddressRequest verifyEmailAddressRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Verifies an email address. This action causes a confirmation email * message to be sent to the specified address. *

*

* This action is throttled at one request per second. *

* * @param verifyEmailIdentityRequest Container for the necessary * parameters to execute the VerifyEmailIdentity operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * VerifyEmailIdentity service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future verifyEmailIdentityAsync(VerifyEmailIdentityRequest verifyEmailIdentityRequest) throws AmazonServiceException, AmazonClientException; /** *

* Verifies an email address. This action causes a confirmation email * message to be sent to the specified address. *

*

* This action is throttled at one request per second. *

* * @param verifyEmailIdentityRequest Container for the necessary * parameters to execute the VerifyEmailIdentity operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * VerifyEmailIdentity service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future verifyEmailIdentityAsync(VerifyEmailIdentityRequest verifyEmailIdentityRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Creates an empty receipt rule set. *

*

* For information about setting up receipt rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param createReceiptRuleSetRequest Container for the necessary * parameters to execute the CreateReceiptRuleSet operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * CreateReceiptRuleSet service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future createReceiptRuleSetAsync(CreateReceiptRuleSetRequest createReceiptRuleSetRequest) throws AmazonServiceException, AmazonClientException; /** *

* Creates an empty receipt rule set. *

*

* For information about setting up receipt rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param createReceiptRuleSetRequest Container for the necessary * parameters to execute the CreateReceiptRuleSet operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * CreateReceiptRuleSet service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future createReceiptRuleSetAsync(CreateReceiptRuleSetRequest createReceiptRuleSetRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified sending authorization policy for the given * identity (email address or domain). This API returns successfully even * if a policy with the specified name does not exist. *

*

* NOTE:This API is for the identity owner only. If you have not * verified the identity, this API will return an error. *

*

* Sending authorization is a feature that enables an identity owner to * authorize other senders to use its identities. For information about * using sending authorization, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param deleteIdentityPolicyRequest Container for the necessary * parameters to execute the DeleteIdentityPolicy operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * DeleteIdentityPolicy service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteIdentityPolicyAsync(DeleteIdentityPolicyRequest deleteIdentityPolicyRequest) throws AmazonServiceException, AmazonClientException; /** *

* Deletes the specified sending authorization policy for the given * identity (email address or domain). This API returns successfully even * if a policy with the specified name does not exist. *

*

* NOTE:This API is for the identity owner only. If you have not * verified the identity, this API will return an error. *

*

* Sending authorization is a feature that enables an identity owner to * authorize other senders to use its identities. For information about * using sending authorization, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param deleteIdentityPolicyRequest Container for the necessary * parameters to execute the DeleteIdentityPolicy operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DeleteIdentityPolicy service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future deleteIdentityPolicyAsync(DeleteIdentityPolicyRequest deleteIdentityPolicyRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Returns the user's sending statistics. The result is a list of data * points, representing the last two weeks of sending activity. *

*

* Each data point in the list contains statistics for a 15-minute * interval. *

*

* This action is throttled at one request per second. *

* * @param getSendStatisticsRequest Container for the necessary parameters * to execute the GetSendStatistics operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * GetSendStatistics service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future getSendStatisticsAsync(GetSendStatisticsRequest getSendStatisticsRequest) throws AmazonServiceException, AmazonClientException; /** *

* Returns the user's sending statistics. The result is a list of data * points, representing the last two weeks of sending activity. *

*

* Each data point in the list contains statistics for a 15-minute * interval. *

*

* This action is throttled at one request per second. *

* * @param getSendStatisticsRequest Container for the necessary parameters * to execute the GetSendStatistics operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * GetSendStatistics service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future getSendStatisticsAsync(GetSendStatisticsRequest getSendStatisticsRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Given a list of verified identities (email addresses and/or domains), * returns a structure describing identity notification attributes. *

*

* This action is throttled at one request per second and can only get * notification attributes for up to 100 identities at a time. *

*

* For more information about using notifications with Amazon SES, see * the * Amazon SES Developer Guide * . *

* * @param getIdentityNotificationAttributesRequest Container for the * necessary parameters to execute the GetIdentityNotificationAttributes * operation on AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * GetIdentityNotificationAttributes service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future getIdentityNotificationAttributesAsync(GetIdentityNotificationAttributesRequest getIdentityNotificationAttributesRequest) throws AmazonServiceException, AmazonClientException; /** *

* Given a list of verified identities (email addresses and/or domains), * returns a structure describing identity notification attributes. *

*

* This action is throttled at one request per second and can only get * notification attributes for up to 100 identities at a time. *

*

* For more information about using notifications with Amazon SES, see * the * Amazon SES Developer Guide * . *

* * @param getIdentityNotificationAttributesRequest Container for the * necessary parameters to execute the GetIdentityNotificationAttributes * operation on AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * GetIdentityNotificationAttributes service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future getIdentityNotificationAttributesAsync(GetIdentityNotificationAttributesRequest getIdentityNotificationAttributesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Returns the metadata and receipt rules for the receipt rule set that * is currently active. *

*

* For information about setting up receipt rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param describeActiveReceiptRuleSetRequest Container for the necessary * parameters to execute the DescribeActiveReceiptRuleSet operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * DescribeActiveReceiptRuleSet service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future describeActiveReceiptRuleSetAsync(DescribeActiveReceiptRuleSetRequest describeActiveReceiptRuleSetRequest) throws AmazonServiceException, AmazonClientException; /** *

* Returns the metadata and receipt rules for the receipt rule set that * is currently active. *

*

* For information about setting up receipt rule sets, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param describeActiveReceiptRuleSetRequest Container for the necessary * parameters to execute the DescribeActiveReceiptRuleSet operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeActiveReceiptRuleSet service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future describeActiveReceiptRuleSetAsync(DescribeActiveReceiptRuleSetRequest describeActiveReceiptRuleSetRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Returns the details of the specified receipt rule. *

*

* For information about setting up receipt rules, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param describeReceiptRuleRequest Container for the necessary * parameters to execute the DescribeReceiptRule operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * DescribeReceiptRule service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future describeReceiptRuleAsync(DescribeReceiptRuleRequest describeReceiptRuleRequest) throws AmazonServiceException, AmazonClientException; /** *

* Returns the details of the specified receipt rule. *

*

* For information about setting up receipt rules, see the * Amazon SES Developer Guide * . *

*

* This action is throttled at one request per second. *

* * @param describeReceiptRuleRequest Container for the necessary * parameters to execute the DescribeReceiptRule operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * DescribeReceiptRule service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future describeReceiptRuleAsync(DescribeReceiptRuleRequest describeReceiptRuleRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Returns a list containing all of the email addresses that have been * verified. *

*

* IMPORTANT:The ListVerifiedEmailAddresses action is deprecated * as of the May 15, 2012 release of Domain Verification. The * ListIdentities action is now preferred. *

*

* This action is throttled at one request per second. *

* * @param listVerifiedEmailAddressesRequest Container for the necessary * parameters to execute the ListVerifiedEmailAddresses operation on * AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * ListVerifiedEmailAddresses service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future listVerifiedEmailAddressesAsync(ListVerifiedEmailAddressesRequest listVerifiedEmailAddressesRequest) throws AmazonServiceException, AmazonClientException; /** *

* Returns a list containing all of the email addresses that have been * verified. *

*

* IMPORTANT:The ListVerifiedEmailAddresses action is deprecated * as of the May 15, 2012 release of Domain Verification. The * ListIdentities action is now preferred. *

*

* This action is throttled at one request per second. *

* * @param listVerifiedEmailAddressesRequest Container for the necessary * parameters to execute the ListVerifiedEmailAddresses operation on * AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * ListVerifiedEmailAddresses service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future listVerifiedEmailAddressesAsync(ListVerifiedEmailAddressesRequest listVerifiedEmailAddressesRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; /** *

* Returns a set of DKIM tokens for a domain. DKIM tokens are * character strings that represent your domain's identity. Using these * tokens, you will need to create DNS CNAME records that point to DKIM * public keys hosted by Amazon SES. Amazon Web Services will eventually * detect that you have updated your DNS records; this detection process * may take up to 72 hours. Upon successful detection, Amazon SES will be * able to DKIM-sign email originating from that domain. *

*

* This action is throttled at one request per second. *

*

* To enable or disable Easy DKIM signing for a domain, use the * SetIdentityDkimEnabled action. *

*

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

* * @param verifyDomainDkimRequest Container for the necessary parameters * to execute the VerifyDomainDkim operation on AmazonSimpleEmailService. * * @return A Java Future object containing the response from the * VerifyDomainDkim service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future verifyDomainDkimAsync(VerifyDomainDkimRequest verifyDomainDkimRequest) throws AmazonServiceException, AmazonClientException; /** *

* Returns a set of DKIM tokens for a domain. DKIM tokens are * character strings that represent your domain's identity. Using these * tokens, you will need to create DNS CNAME records that point to DKIM * public keys hosted by Amazon SES. Amazon Web Services will eventually * detect that you have updated your DNS records; this detection process * may take up to 72 hours. Upon successful detection, Amazon SES will be * able to DKIM-sign email originating from that domain. *

*

* This action is throttled at one request per second. *

*

* To enable or disable Easy DKIM signing for a domain, use the * SetIdentityDkimEnabled action. *

*

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

* * @param verifyDomainDkimRequest Container for the necessary parameters * to execute the VerifyDomainDkim operation on AmazonSimpleEmailService. * @param asyncHandler Asynchronous callback handler for events in the * life-cycle of the request. Users could provide the implementation of * the four callback methods in this interface to process the operation * result or handle the exception. * * @return A Java Future object containing the response from the * VerifyDomainDkim service method, as returned by * AmazonSimpleEmailService. * * * @throws AmazonClientException * If any internal errors are encountered inside the client while * attempting to make the request or handle the response. For example * if a network connection is not available. * @throws AmazonServiceException * If an error response is returned by AmazonSimpleEmailService indicating * either a problem with the data in the request, or a server side issue. */ public Future verifyDomainDkimAsync(VerifyDomainDkimRequest verifyDomainDkimRequest, AsyncHandler asyncHandler) throws AmazonServiceException, AmazonClientException; }




© 2015 - 2025 Weber Informatics LLC | Privacy Policy