com.amazonaws.services.simpleemail

インタフェース AmazonSimpleEmailService

既知のサブインタフェースのリスト:

AmazonSimpleEmailServiceAsync

既知の実装クラスのリスト:

AmazonSimpleEmailServiceAsyncClient, AmazonSimpleEmailServiceClient

public interface AmazonSimpleEmailService

AmazonSimpleEmailService にアクセスするためのインターフェース Amazon Simple Email Service

これは Amazon Simple Email Service (Amazon SES) の API リファレンスです。 この文書は Amazon SES 入門ガイドおよび Amazon SES 開発者ガイドと併せてご覧ください。

サービスリクエストの具体的な作成方法については Amazon SES 開発者ガイド をご覧ください。

NOTE:Amazon SES のエンドポイントは https://email.us-east-1.amazonaws.com です。

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
DeleteIdentityResult	deleteIdentity(DeleteIdentityRequest deleteIdentityRequest) 検証済みの送信元IDの一覧から、指定したID (電子メールアドレスもしくはドメイン) を削除します。
void	deleteVerifiedEmailAddress(DeleteVerifiedEmailAddressRequest deleteVerifiedEmailAddressRequest) 検証済みの電子メールアドレスのリストの中から指定した電子メールアドレスを削除します。
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) 最後に成功したリクエストに対する追加のメタデータを返します。
GetIdentityDkimAttributesResult	getIdentityDkimAttributes(GetIdentityDkimAttributesRequest getIdentityDkimAttributesRequest) 送信する電子メールに Easy DKIM 署名をする際に必要となる DNS レコード (トークン) 一式を返します。
GetIdentityNotificationAttributesResult	getIdentityNotificationAttributes(GetIdentityNotificationAttributesRequest getIdentityNotificationAttributesRequest) 検証済みの送信元ID (電子メールアドレスとドメインまたはそのどちらか) のリストを受け取り、 ID の通知に関する属性値のデータ構造を返します。
GetIdentityVerificationAttributesResult	getIdentityVerificationAttributes(GetIdentityVerificationAttributesRequest getIdentityVerificationAttributesRequest) 送信元ID (電子メールアドレスとドメインまたはそのどちらか) のリストを受け取り、 それぞれの ID の検証状況および (ドメインの場合のみ) 検証トークンを返します。
GetSendQuotaResult	getSendQuota() ユーザに対する現在の送信上限値を返します。
GetSendQuotaResult	getSendQuota(GetSendQuotaRequest getSendQuotaRequest) ユーザに対する現在の送信上限値を返します。
GetSendStatisticsResult	getSendStatistics() ユーザが送信したメールの統計情報を返します。
GetSendStatisticsResult	getSendStatistics(GetSendStatisticsRequest getSendStatisticsRequest) ユーザが送信したメールの統計情報を返します。
ListIdentitiesResult	listIdentities() 指定した AWS アカウントに登録しているすべての送信元ID (メールアドレスおよびドメイン) のリストを返します。
ListIdentitiesResult	listIdentities(ListIdentitiesRequest listIdentitiesRequest) 指定した AWS アカウントに登録しているすべての送信元ID (メールアドレスおよびドメイン) のリストを返します。
ListVerifiedEmailAddressesResult	listVerifiedEmailAddresses() 検証済みのすべての電子メールアドレスのリストを返します。
ListVerifiedEmailAddressesResult	listVerifiedEmailAddresses(ListVerifiedEmailAddressesRequest listVerifiedEmailAddressesRequest) 検証済みのすべての電子メールアドレスのリストを返します。
SendEmailResult	sendEmail(SendEmailRequest sendEmailRequest) 入力したデータを基にして電子メールメッセージを組み立て、 すぐに作成したメッセージを送信キューに格納します。
SendRawEmailResult	sendRawEmail(SendRawEmailRequest sendRawEmailRequest) クライアントが指定したメールヘッダとボディを使用して電子メールを送信します。
void	setEndpoint(java.lang.String endpoint) このクライアントのデフォルトのエンドポイント ("https://email.us-east-1.amazonaws.com") を変更します。
SetIdentityDkimEnabledResult	setIdentityDkimEnabled(SetIdentityDkimEnabledRequest setIdentityDkimEnabledRequest) 送信元ID に対して、そこから送信する電子メールに Easy DKIM 署名を行うか行わないかを設定します。
SetIdentityFeedbackForwardingEnabledResult	setIdentityFeedbackForwardingEnabled(SetIdentityFeedbackForwardingEnabledRequest setIdentityFeedbackForwardingEnabledRequest) 指定した送信元 ID (電子メールアドレスまたはドメイン) に対して、 Amazon SES が受け取ったフィードバック通知を電子メール形式で送信元に転送するかどうかを設定します。
SetIdentityNotificationTopicResult	setIdentityNotificationTopic(SetIdentityNotificationTopicRequest setIdentityNotificationTopicRequest) 送信元ID (電子メールアドレスもしくはドメイン) に対して Amazon SNS トピックを設定します。
void	setRegion(Region region) このクライアントのサービスコールで使用するリージョンのエンドポイントを指定する setEndpoint(String) に代わるもう一つの方法です。
void	shutdown() 開いているすべてのリソースを解放して、クライアントオブジェクトを終了します。
VerifyDomainDkimResult	verifyDomainDkim(VerifyDomainDkimRequest verifyDomainDkimRequest) DNS レコード (トークン) 一式を返します。
VerifyDomainIdentityResult	verifyDomainIdentity(VerifyDomainIdentityRequest verifyDomainIdentityRequest) ドメインの検証手続きを開始します。
void	verifyEmailAddress(VerifyEmailAddressRequest verifyEmailAddressRequest) 電子メールアドレスの検証手続きを開始します。
VerifyEmailIdentityResult	verifyEmailIdentity(VerifyEmailIdentityRequest verifyEmailIdentityRequest) 電子メールアドレスの検証手続きを開始します。

メソッドの詳細

setEndpoint

void setEndpoint(java.lang.String endpoint)
                 throws java.lang.IllegalArgumentException

このクライアントのデフォルトのエンドポイント ("https://email.us-east-1.amazonaws.com") を変更します。 このメソッドを使用して、利用したい AWS リージョンに切り替えることができます。

引数にはエンドポイント (例: "email.us-east-1.amazonaws.com") のみを渡すか、 プロトコルを含めたURL全体 (例: "https://email.us-east-1.amazonaws.com") を渡すことができます。 プロトコルを指定していなければ、デフォルトのプロトコルはクライアントの ClientConfiguration の設定値が、設定が無ければ HTTPS が使用されます。

AWS SDK for Java で AWS リージョンを扱うための詳細情報および、 利用可能な全エンドポイントをすべての AWS サービスについてまとめた一覧は http://developer.amazonwebservices.com/connect/entry.jspa?externalID=3912 をご覧ください。

このメソッドはスレッドセーフではありません。 エンドポイントの変更をする場合、クライアントを作成してから サービスにリクエストを出すまでの間に行わなければなりません。 リクエスト後に変更すると、転送中やリトライ中のリクエストは競合状態に陥ります。

パラメータ:

endpoint - The endpoint (ex: "email.us-east-1.amazonaws.com") or a full URL, including the protocol (ex: "https://email.us-east-1.amazonaws.com") of the region specific AWS endpoint this client will communicate with.

例外:

java.lang.IllegalArgumentException - If any problems are detected with the specified endpoint.

setRegion

void setRegion(Region region)
               throws java.lang.IllegalArgumentException

このクライアントのサービスコールで使用するリージョンのエンドポイントを指定する setEndpoint(String) に代わるもう一つの方法です。 このメソッドを使用して、利用したい AWS リージョンに切り替えることができます。

デフォルトでは、すべてのリージョンのサービスエンドポイントで HTTPS プロトコルを使用します。 代わりに HTTP を使用するには、クライアント生成時に ClientConfiguration に指定してください。

このメソッドはスレッドセーフではありません。 リージョンの変更をする場合、クライアントを作成してから サービスにリクエストを出すまでの間に行わなければなりません。 リクエスト後に変更すると、転送中やリトライ中のリクエストは競合状態に陥ります。

パラメータ:

region - The region this client will communicate with. See Region.getRegion(com.amazonaws.regions.Regions) for accessing a given region.

例外:

java.lang.IllegalArgumentException - If the given region is null, or if this service isn't available in the given region. See Region.isServiceSupported(String)

関連項目:

Region.getRegion(com.amazonaws.regions.Regions), Region.createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration)

deleteIdentity

DeleteIdentityResult deleteIdentity(DeleteIdentityRequest deleteIdentityRequest)
                                    throws AmazonServiceException,
                                           AmazonClientException

検証済みの送信元IDの一覧から、指定したID (電子メールアドレスもしくはドメイン) を削除します。

パラメータ:

deleteIdentityRequest - Container for the necessary parameters to execute the DeleteIdentity service method on AmazonSimpleEmailService.

戻り値:

The response from the DeleteIdentity service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

listVerifiedEmailAddresses

ListVerifiedEmailAddressesResult listVerifiedEmailAddresses(ListVerifiedEmailAddressesRequest listVerifiedEmailAddressesRequest)
                                                            throws AmazonServiceException,
                                                                   AmazonClientException

検証済みのすべての電子メールアドレスのリストを返します。

IMPORTANT:The ListVerifiedEmailAddresses アクションは ドメイン検証機能がリリースされた 2012 年 5 月 15 日に廃止予定になりました。 ListIdentities アクションの使用を推奨します。

パラメータ:

listVerifiedEmailAddressesRequest - Container for the necessary parameters to execute the ListVerifiedEmailAddresses service method on AmazonSimpleEmailService.

戻り値:

The response from the ListVerifiedEmailAddresses service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

getSendStatistics

GetSendStatisticsResult getSendStatistics(GetSendStatisticsRequest getSendStatisticsRequest)
                                          throws AmazonServiceException,
                                                 AmazonClientException

ユーザが送信したメールの統計情報を返します。 戻り値は、過去 2 週間分の送信履歴からなるデータ要素のリストになっています。

リスト内のそれぞれのデータ要素は、15分間隔の統計情報です。

パラメータ:

getSendStatisticsRequest - Container for the necessary parameters to execute the GetSendStatistics service method on AmazonSimpleEmailService.

戻り値:

The response from the GetSendStatistics service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

verifyEmailIdentity

VerifyEmailIdentityResult verifyEmailIdentity(VerifyEmailIdentityRequest verifyEmailIdentityRequest)
                                              throws AmazonServiceException,
                                                     AmazonClientException

電子メールアドレスの検証手続きを開始します。 このアクションを実行すると、指定した電子メールアドレス宛に確認メールが送信されます。

パラメータ:

verifyEmailIdentityRequest - Container for the necessary parameters to execute the VerifyEmailIdentity service method on AmazonSimpleEmailService.

戻り値:

The response from the VerifyEmailIdentity service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

getIdentityNotificationAttributes

GetIdentityNotificationAttributesResult getIdentityNotificationAttributes(GetIdentityNotificationAttributesRequest getIdentityNotificationAttributesRequest)
                                                                          throws AmazonServiceException,
                                                                                 AmazonClientException

検証済みの送信元ID (電子メールアドレスとドメインまたはそのどちらか) のリストを受け取り、 ID の通知に関する属性値のデータ構造を返します。 フィードバック通知に関する詳細情報は Amazon SES 開発者ガイド をご覧ください。

パラメータ:

getIdentityNotificationAttributesRequest - Container for the necessary parameters to execute the GetIdentityNotificationAttributes service method on AmazonSimpleEmailService.

戻り値:

The response from the GetIdentityNotificationAttributes service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

verifyDomainDkim

VerifyDomainDkimResult verifyDomainDkim(VerifyDomainDkimRequest verifyDomainDkimRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

DNS レコード (トークン) 一式を返します。 DKIM 検証手続きを完了させるには、これを対象のドメインのDNSサーバで公開する必要があります。 これらのトークンは Amazon SES が提供している DKIM 公開鍵の場所を指し示す DNS の CNAME レコードです。 DKIM 検証手続きを完了するためには、これらのトークンを対象のドメインのDNSサーバで 公開しなければなりません。 Easy DKIM 署名を正しく機能させるには、公開したままにしておく必要があります。

Amazon SES では、対象のドメインのDNSサーバにトークンが追加されると、 そのドメインから送信する電子メールに DKIM 署名を付けられるようになります。 ドメインに対して Easy DKIM 署名を有効にするもしくは無効にする設定を行うには、 SetIdentityDkimEnabled アクションを使用してください。

Easy DKIM に関する詳細情報は、 Amazon SES 開発者ガイド をご覧ください。

パラメータ:

verifyDomainDkimRequest - Container for the necessary parameters to execute the VerifyDomainDkim service method on AmazonSimpleEmailService.

戻り値:

The response from the VerifyDomainDkim service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

getIdentityDkimAttributes

GetIdentityDkimAttributesResult getIdentityDkimAttributes(GetIdentityDkimAttributesRequest getIdentityDkimAttributesRequest)
                                                          throws AmazonServiceException,
                                                                 AmazonClientException

送信する電子メールに Easy DKIM 署名をする際に必要となる DNS レコード (トークン) 一式を返します。

このアクションは、検証済みの ID のリストを受け取り、 それぞれの ID に関する次の情報をかえします。

• メール送信時の Easy DKIM 署名を有効にしているかどうか。
• Easy DKIM 署名に必要なトークン一式。これらのトークンは DKIM 検証手続きを完了させるために対象ドメインのDNSレコードとして公開して おかなければなりません。また、Easy DKIM 署名処理を正常に行うためには 公開し続けなければなりません。 (この情報は ID が電子メールアドレスではなく、 ドメインのときにのみ返されます。)
• 対象のドメインのDNSサーバに DKIM トークンが公開されていることを、 Amazon SES が正しく検証できたかどうか (この情報は ID が電子メールアドレスではなく、 ドメインのときにのみ返されます。)

Easy DKIM に関する詳細情報は、 Amazon SES 開発者ガイド をご覧ください。

パラメータ:

getIdentityDkimAttributesRequest - Container for the necessary parameters to execute the GetIdentityDkimAttributes service method on AmazonSimpleEmailService.

戻り値:

The response from the GetIdentityDkimAttributes service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

verifyEmailAddress

void verifyEmailAddress(VerifyEmailAddressRequest verifyEmailAddressRequest)
                        throws AmazonServiceException,
                               AmazonClientException

電子メールアドレスの検証手続きを開始します。 このアクションを実行すると、指定した電子メールアドレス宛に確認メールが送信されます。

IMPORTANT:The VerifyEmailAddress アクションは ドメイン検証機能がリリースされた 2012 年 5 月 15 日に廃止予定になりました。 VerifyEmailIdentityアクションの使用を推奨します。

パラメータ:

verifyEmailAddressRequest - Container for the necessary parameters to execute the VerifyEmailAddress service method on AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

sendRawEmail

SendRawEmailResult sendRawEmail(SendRawEmailRequest sendRawEmailRequest)
                                throws AmazonServiceException,
                                       AmazonClientException

クライアントが指定したメールヘッダとボディを使用して電子メールを送信します。 この SendRawEmail アクションは、マルチパート MIME 電子メールを送信する場合に 役に立ちます。メッセージの生のテキストは、インターネットの電子メールの規格に準拠している 必要があり、そうでない場合にはメッセージは送信できません。

IMPORTANT:プロダクション環境へのアクセス申請をしていない場合には、 送信元だけでなく送信先も検証済みの電子メールアドレスもしくは 検証済みのドメインでなければなりません。 詳しくは Amazon SES 開発者ガイドをご覧ください。

メッセージの合計サイズは 10MB 以下でなければなりません。 これには添付ファイル等のメッセージを構成するすべてのデータを含みます。

Amazon SES には1通のメッセージにおける受取人の最大人数が決められています。 To:、CC: および BCC: に指定する電子メールアドレス数の合計は 50以下でなければなりません。 1通のメッセージをより多くの人に送信したい場合には、 受取人のリストを50以下のグループに分割して、 グループごとにそれぞれ Amazon SES を呼び出せば送信可能です。

送信したすべてのメッセージの受取人 (To:、CC:、BCC:) の合計人数は、 sending quota (過去 24 時間の間に送信できるメールの上限値) としてカウントさています。 送信上限の関する詳細は、 Amazon SES 開発者ガイド の "送信量を管理する" を参照してください。

パラメータ:

sendRawEmailRequest - Container for the necessary parameters to execute the SendRawEmail service method on AmazonSimpleEmailService.

戻り値:

The response from the SendRawEmail service method, as returned by AmazonSimpleEmailService.

例外:

MessageRejectedException

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

listIdentities

ListIdentitiesResult listIdentities(ListIdentitiesRequest listIdentitiesRequest)
                                    throws AmazonServiceException,
                                           AmazonClientException

指定した AWS アカウントに登録しているすべての送信元ID (メールアドレスおよびドメイン) のリストを返します。IDの検証ステータスがどのようになっているのかは問いません。

パラメータ:

listIdentitiesRequest - Container for the necessary parameters to execute the ListIdentities service method on AmazonSimpleEmailService.

戻り値:

The response from the ListIdentities service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

getIdentityVerificationAttributes

GetIdentityVerificationAttributesResult getIdentityVerificationAttributes(GetIdentityVerificationAttributesRequest getIdentityVerificationAttributesRequest)
                                                                          throws AmazonServiceException,
                                                                                 AmazonClientException

送信元ID (電子メールアドレスとドメインまたはそのどちらか) のリストを受け取り、 それぞれの ID の検証状況および (ドメインの場合のみ) 検証トークンを返します。

パラメータ:

getIdentityVerificationAttributesRequest - Container for the necessary parameters to execute the GetIdentityVerificationAttributes service method on AmazonSimpleEmailService.

戻り値:

The response from the GetIdentityVerificationAttributes service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

setIdentityDkimEnabled

SetIdentityDkimEnabledResult setIdentityDkimEnabled(SetIdentityDkimEnabledRequest setIdentityDkimEnabledRequest)
                                                    throws AmazonServiceException,
                                                           AmazonClientException

送信元ID に対して、そこから送信する電子メールに Easy DKIM 署名を行うか行わないかを設定します。

• 有効にする ID がドメイン(例: example.com )の場合、 Amazon SES はそのドメイン下の電子メールアドレス(例: user@example.com ) から送るすべての電子メールに署名を行います。
• 有効にする ID が電子メールアドレスの場合、Amazon SES はその電子メールアドレスから 送るすべての電子メールに署名を行います。

電子メールアドレス(例: user@exmple.com ) の場合には、 あらかじめ AWS 管理コンソールもしくは VerifyDomainDkim アクションを使用して、 電子メールドレスが所属するドメイン (例: example.com ) の Easy DKIM の設定を済ませている場合のみ、Easy DKIM 署名を有効にすることができます。

Easy DKIM に関する詳細情報は、 Amazon SES 開発者ガイド をご覧ください。

パラメータ:

setIdentityDkimEnabledRequest - Container for the necessary parameters to execute the SetIdentityDkimEnabled service method on AmazonSimpleEmailService.

戻り値:

The response from the SetIdentityDkimEnabled service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

getSendQuota

GetSendQuotaResult getSendQuota(GetSendQuotaRequest getSendQuotaRequest)
                                throws AmazonServiceException,
                                       AmazonClientException

ユーザに対する現在の送信上限値を返します。

パラメータ:

getSendQuotaRequest - Container for the necessary parameters to execute the GetSendQuota service method on AmazonSimpleEmailService.

戻り値:

The response from the GetSendQuota service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

setIdentityFeedbackForwardingEnabled

SetIdentityFeedbackForwardingEnabledResult setIdentityFeedbackForwardingEnabled(SetIdentityFeedbackForwardingEnabledRequest setIdentityFeedbackForwardingEnabledRequest)
                                                                                throws AmazonServiceException,
                                                                                       AmazonClientException

指定した送信元 ID (電子メールアドレスまたはドメイン) に対して、 Amazon SES が受け取ったフィードバック通知を電子メール形式で送信元に転送するかどうかを設定します。 フィードバックの転送を無効にするためには、クレーム通知とバウンス通知のどちらも SNS のトピックに発行する設定をしておかなければなりません。 通知のフィードバックに関する詳細情報は Amazon SES 開発者ガイド をご覧ください。

パラメータ:

setIdentityFeedbackForwardingEnabledRequest - Container for the necessary parameters to execute the SetIdentityFeedbackForwardingEnabled service method on AmazonSimpleEmailService.

戻り値:

The response from the SetIdentityFeedbackForwardingEnabled service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

verifyDomainIdentity

VerifyDomainIdentityResult verifyDomainIdentity(VerifyDomainIdentityRequest verifyDomainIdentityRequest)
                                                throws AmazonServiceException,
                                                       AmazonClientException

ドメインの検証手続きを開始します。

パラメータ:

verifyDomainIdentityRequest - Container for the necessary parameters to execute the VerifyDomainIdentity service method on AmazonSimpleEmailService.

戻り値:

The response from the VerifyDomainIdentity service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

sendEmail

SendEmailResult sendEmail(SendEmailRequest sendEmailRequest)
                          throws AmazonServiceException,
                                 AmazonClientException

入力したデータを基にして電子メールメッセージを組み立て、 すぐに作成したメッセージを送信キューに格納します。

IMPORTANT:プロダクション環境へのアクセス申請をしていない場合には、 送信元だけでなく送信先も検証済みの電子メールアドレスもしくは 検証済みのドメインでなければなりません。 詳しくは Amazon SES 開発者ガイドをご覧ください。

メッセージの合計サイズは 10MB 以下でなければなりません。

Amazon SES には1通のメッセージにおける受取人の最大人数が決められています。 To:、CC: および BCC: に指定する電子メールアドレス数の合計は 50以下でなければなりません。 1通のメッセージをより多くの人に送信したい場合には、 受取人のリストを50以下のグループに分割して、 グループごとにそれぞれ Amazon SES を呼び出せば送信可能です。

送信したすべてのメッセージの受取人 (To:、CC:、BCC:) の合計人数は、 sending quota (過去 24 時間の間に送信できるメールの上限値) としてカウントさています。 送信上限の関する詳細は、 Amazon SES 開発者ガイド の "送信量を管理する" を参照してください。

パラメータ:

sendEmailRequest - Container for the necessary parameters to execute the SendEmail service method on AmazonSimpleEmailService.

戻り値:

The response from the SendEmail service method, as returned by AmazonSimpleEmailService.

例外:

MessageRejectedException

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

deleteVerifiedEmailAddress

void deleteVerifiedEmailAddress(DeleteVerifiedEmailAddressRequest deleteVerifiedEmailAddressRequest)
                                throws AmazonServiceException,
                                       AmazonClientException

検証済みの電子メールアドレスのリストの中から指定した電子メールアドレスを削除します。

IMPORTANT:The DeleteVerifiedEmailAddress アクションは ドメイン検証機能がリリースされた 2012 年 5 月 15 日に廃止予定になりました。 DeleteIdentity アクションの使用を推奨します。

パラメータ:

deleteVerifiedEmailAddressRequest - Container for the necessary parameters to execute the DeleteVerifiedEmailAddress service method on AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

setIdentityNotificationTopic

SetIdentityNotificationTopicResult setIdentityNotificationTopic(SetIdentityNotificationTopicRequest setIdentityNotificationTopicRequest)
                                                                throws AmazonServiceException,
                                                                       AmazonClientException

送信元ID (電子メールアドレスもしくはドメイン) に対して Amazon SNS トピックを設定します。 Amazon SES はこのトピックに対して、 その ID を Source として送信したメールに対する バウンスおよびクレーム通知を発行します。 通知を電子メールで転送する設定を有効にしている場合のみ、 トピックへの発行を無効にすることができます。 通知のフィードバックに関する詳細情報は Amazon SES 開発者ガイド をご覧ください。

パラメータ:

setIdentityNotificationTopicRequest - Container for the necessary parameters to execute the SetIdentityNotificationTopic service method on AmazonSimpleEmailService.

戻り値:

The response from the SetIdentityNotificationTopic service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

listVerifiedEmailAddresses

ListVerifiedEmailAddressesResult listVerifiedEmailAddresses()
                                                            throws AmazonServiceException,
                                                                   AmazonClientException

検証済みのすべての電子メールアドレスのリストを返します。

IMPORTANT:The ListVerifiedEmailAddresses アクションは ドメイン検証機能がリリースされた 2012 年 5 月 15 日に廃止予定になりました。 ListIdentities アクションの使用を推奨します。

戻り値:

The response from the ListVerifiedEmailAddresses service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

getSendStatistics

GetSendStatisticsResult getSendStatistics()
                                          throws AmazonServiceException,
                                                 AmazonClientException

ユーザが送信したメールの統計情報を返します。 戻り値は、過去 2 週間分の送信履歴からなるデータ要素のリストになっています。

リスト内のそれぞれのデータ要素は、15分間隔の統計情報です。

戻り値:

The response from the GetSendStatistics service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

listIdentities

ListIdentitiesResult listIdentities()
                                    throws AmazonServiceException,
                                           AmazonClientException

指定した AWS アカウントに登録しているすべての送信元ID (メールアドレスおよびドメイン) のリストを返します。IDの検証ステータスがどのようになっているのかは問いません。

戻り値:

The response from the ListIdentities service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

getSendQuota

GetSendQuotaResult getSendQuota()
                                throws AmazonServiceException,
                                       AmazonClientException

ユーザに対する現在の送信上限値を返します。

戻り値:

The response from the GetSendQuota service method, as returned by AmazonSimpleEmailService.

例外:

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.

AmazonServiceException - If an error response is returned by AmazonSimpleEmailService indicating either a problem with the data in the request, or a server side issue.

shutdown

void shutdown()

開いているすべてのリソースを解放して、クライアントオブジェクトを終了します。 このメソッドはオプションであり通常使用する必要はありませんが、 すべてのリソースを明示的に解放したい場合には使用しても構いません。 一度終了させたクライアントでは、それ以降リクエストは発行できなくなります。

getCachedResponseMetadata

ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

最後に成功したリクエストに対する追加のメタデータを返します。 通常、サービスが期待通りの動作をしなかった時の問題解決に利用します。 メタデータはオペレーションによって返されるデータの一部とはみなされておらず、 別途この診断インターフェースを通じて入手可能です。

レスポンスのメタデータは一定期間しか保持しないので、 このメタデータつまり実行したリクエストに対する追加の診断情報にアクセスしたいのであれば、 リクエストを実行した後できるだけ早くこのメソッドを使って取得してください。

パラメータ:

request - The originally executed request.

戻り値:

The response metadata for the specified request, or null if none is available.