com.amazonaws.services.simpleemail

クラス AmazonSimpleEmailServiceClient

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.simpleemail.AmazonSimpleEmailServiceClient

すべての実装されたインタフェース:

AmazonSimpleEmailService

直系の既知のサブクラス:

AmazonSimpleEmailServiceAsyncClient

public class AmazonSimpleEmailServiceClient
extends AmazonWebServiceClient
implements AmazonSimpleEmailService

AmazonSompleEmailService にアクセスするためのクライアント このクライアントを使用したサービスコールはすべてブロッキング通信になり、 処理が完了するまで戻りません。

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 です。

フィールドの概要

フィールド

修飾子とタイプ	フィールドと説明
protected java.util.List<com.amazonaws.transform.Unmarshaller<AmazonServiceException,org.w3c.dom.Node>>	exceptionUnmarshallers 全ての AmazonSimpleEmailService の例外を処理するアンマーシャラのリスト

クラスから継承されたフィールド com.amazonaws.AmazonWebServiceClient

client, clientConfiguration, endpoint, requestHandlers, timeOffset, version

コンストラクタの概要

コンストラクタ

コンストラクタと説明
AmazonSimpleEmailServiceClient() AmazonSimpleEmailService サービスのメソッドを呼び出すための新しいクライアントを生成します。
AmazonSimpleEmailServiceClient(AWSCredentials awsCredentials) 指定したAWSアカウントの認証情報を使用して、 AmazonSimpleEmailService サービスのメソッドを呼び出すための新しいクライアントを生成します。
AmazonSimpleEmailServiceClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration) 指定したAWSアカウントの認証情報およびクライアントのオプション設定を使用して、 AmazonSimpleEmailService サービスのメソッドを呼び出すための新しいクライアントを生成します。
AmazonSimpleEmailServiceClient(AWSCredentialsProvider awsCredentialsProvider) 指定した AWS アカウントの認証情報プロバイダを使用して、 AmazonSimpleEmailService サービスのメソッドを呼び出すための新しいクライアントを生成します。
AmazonSimpleEmailServiceClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration) 指定した AWS アカウントの認証情報プロバイダおよびクライアントのオプション設定を使用して、 AmazonSimpleEmailService サービスのメソッドを呼び出すための新しいクライアントを生成します。
AmazonSimpleEmailServiceClient(ClientConfiguration clientConfiguration) AmazonSimpleEmailService サービスのメソッドを呼び出すための新しいクライアントを生成します。

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
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) ユーザが送信したメールの統計情報を返します。
protected java.lang.String	getServiceAbbreviation() リージョンによるサービスエンドポイントを特定するために、このサービスに対する 略称を返します
ListIdentitiesResult	listIdentities() 指定した AWS アカウントに登録しているすべての送信元ID (メールアドレスおよびドメイン) のリストを返します。
ListIdentitiesResult	listIdentities(ListIdentitiesRequest listIdentitiesRequest) 指定した AWS アカウントに登録しているすべての送信元ID (メールアドレスおよびドメイン) のリストを返します。
ListVerifiedEmailAddressesResult	listVerifiedEmailAddresses() 検証済みのすべての電子メールアドレスのリストを返します。
ListVerifiedEmailAddressesResult	listVerifiedEmailAddresses(ListVerifiedEmailAddressesRequest listVerifiedEmailAddressesRequest) 検証済みのすべての電子メールアドレスのリストを返します。
SendEmailResult	sendEmail(SendEmailRequest sendEmailRequest) 入力したデータを基にして電子メールメッセージを組み立て、 すぐに作成したメッセージを送信キューに格納します。
SendRawEmailResult	sendRawEmail(SendRawEmailRequest sendRawEmailRequest) クライアントが指定したメールヘッダとボディを使用して電子メールを送信します。
SetIdentityDkimEnabledResult	setIdentityDkimEnabled(SetIdentityDkimEnabledRequest setIdentityDkimEnabledRequest) 送信元ID に対して、そこから送信する電子メールに Easy DKIM 署名を行うか行わないかを設定します。
SetIdentityFeedbackForwardingEnabledResult	setIdentityFeedbackForwardingEnabled(SetIdentityFeedbackForwardingEnabledRequest setIdentityFeedbackForwardingEnabledRequest) 指定した送信元 ID (電子メールアドレスまたはドメイン) に対して、 Amazon SES が受け取ったフィードバック通知を電子メール形式で送信元に転送するかどうかを設定します。
SetIdentityNotificationTopicResult	setIdentityNotificationTopic(SetIdentityNotificationTopicRequest setIdentityNotificationTopicRequest) 送信元ID (電子メールアドレスもしくはドメイン) に対して Amazon SNS トピックを設定します。
VerifyDomainDkimResult	verifyDomainDkim(VerifyDomainDkimRequest verifyDomainDkimRequest) DNS レコード (トークン) 一式を返します。
VerifyDomainIdentityResult	verifyDomainIdentity(VerifyDomainIdentityRequest verifyDomainIdentityRequest) ドメインの検証手続きを開始します。
void	verifyEmailAddress(VerifyEmailAddressRequest verifyEmailAddressRequest) 電子メールアドレスの検証手続きを開始します。
VerifyEmailIdentityResult	verifyEmailIdentity(VerifyEmailIdentityRequest verifyEmailIdentityRequest) 電子メールアドレスの検証手続きを開始します。

クラスから継承されたメソッド com.amazonaws.AmazonWebServiceClient

addRequestHandler, convertToHttpRequest, createExecutionContext, getTimeOffset, getVersion, removeRequestHandler, setConfiguration, setEndpoint, setRegion, setTimeOffset, setVersion, shutdown, withTimeOffset

クラスから継承されたメソッド java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

インタフェースから継承されたメソッド com.amazonaws.services.simpleemail.AmazonSimpleEmailService

setEndpoint, setRegion, shutdown

フィールドの詳細

exceptionUnmarshallers

protected final java.util.List<com.amazonaws.transform.Unmarshaller<AmazonServiceException,org.w3c.dom.Node>> exceptionUnmarshallers

全ての AmazonSimpleEmailService の例外を処理するアンマーシャラのリスト

コンストラクタの詳細

AmazonSimpleEmailServiceClient

public AmazonSimpleEmailServiceClient()

AmazonSimpleEmailService サービスのメソッドを呼び出すための新しいクライアントを生成します。 認証情報を次の順番で検索するために、クレデンシャルプロバイダチェーンを使用しています。

• 環境変数 - AWS_ACCESS_KEY_ID および AWS_SECRET_KEY
• Java のシステムプロパティ - aws.accessKeyId および aws.secretKey
• Amazon EC2 メタデータサービスから取得した EC2 インスタンスプロファイルの認証情報

このクライアントを使用したサービスコールはすべてブロッキング通信になり、 処理が完了するまで戻りません。

関連項目:

DefaultAWSCredentialsProvider

AmazonSimpleEmailServiceClient

public AmazonSimpleEmailServiceClient(ClientConfiguration clientConfiguration)

AmazonSimpleEmailService サービスのメソッドを呼び出すための新しいクライアントを生成します。 認証情報を次の順番で検索するために、クレデンシャルプロバイダチェーンを使用しています。

• 環境変数 - AWS_ACCESS_KEY_ID および AWS_SECRET_KEY
• Java のシステムプロパティ - aws.accessKeyId および aws.secretKey
• Amazon EC2 メタデータサービスから取得した EC2 インスタンスプロファイルの認証情報

このクライアントを使用したサービスコールはすべてブロッキング通信になり、 処理が完了するまで戻りません。

パラメータ:

clientConfiguration - クライアントが AmazonSimpleEmailService に接続する際のオプション設定 (例: プロキシ設定、リトライ回数など)

関連項目:

DefaultAWSCredentialsProvider

AmazonSimpleEmailServiceClient

public AmazonSimpleEmailServiceClient(AWSCredentials awsCredentials)

指定したAWSアカウントの認証情報を使用して、 AmazonSimpleEmailService サービスのメソッドを呼び出すための新しいクライアントを生成します。

このクライアントを使用したサービスコールはすべてブロッキング通信になり、 処理が完了するまで戻りません。

パラメータ:

awsCredentials - AWS サービスの認証時に使用する AWS 認証情報 (access key ID および secret key)

AmazonSimpleEmailServiceClient

public AmazonSimpleEmailServiceClient(AWSCredentials awsCredentials,
                              ClientConfiguration clientConfiguration)

指定したAWSアカウントの認証情報およびクライアントのオプション設定を使用して、 AmazonSimpleEmailService サービスのメソッドを呼び出すための新しいクライアントを生成します。

このクライアントを使用したサービスコールはすべてブロッキング通信になり、 処理が完了するまで戻りません。

パラメータ:

awsCredentials - AWS サービスの認証時に使用する AWS 認証情報 (access key ID および secret key)

clientConfiguration - クライアントが AmazonSimpleEmailService に接続する際のオプション設定 (例: プロキシ設定、リトライ回数など)

AmazonSimpleEmailServiceClient

public AmazonSimpleEmailServiceClient(AWSCredentialsProvider awsCredentialsProvider)

指定した AWS アカウントの認証情報プロバイダを使用して、 AmazonSimpleEmailService サービスのメソッドを呼び出すための新しいクライアントを生成します。

このクライアントを使用したサービスコールはすべてブロッキング通信になり、 処理が完了するまで戻りません。

パラメータ:

awsCredentialsProvider - AWS サービスに対するリクエストに使用する認証情報を提供する AWS 認証情報プロバイダ

AmazonSimpleEmailServiceClient

public AmazonSimpleEmailServiceClient(AWSCredentialsProvider awsCredentialsProvider,
                              ClientConfiguration clientConfiguration)

指定した AWS アカウントの認証情報プロバイダおよびクライアントのオプション設定を使用して、 AmazonSimpleEmailService サービスのメソッドを呼び出すための新しいクライアントを生成します。

このクライアントを使用したサービスコールはすべてブロッキング通信になり、 処理が完了するまで戻りません。

パラメータ:

awsCredentialsProvider - AWS サービスに対するリクエストに使用する認証情報を提供する AWS 認証情報プロバイダ

clientConfiguration - クライアントが AmazonSimpleEmailService に接続する際のオプション設定 (例: プロキシ設定、リトライ回数など)

メソッドの詳細

deleteIdentity

public DeleteIdentityResult deleteIdentity(DeleteIdentityRequest deleteIdentityRequest)
                                    throws AmazonServiceException,
                                           AmazonClientException

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

定義:

deleteIdentity インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public ListVerifiedEmailAddressesResult listVerifiedEmailAddresses(ListVerifiedEmailAddressesRequest listVerifiedEmailAddressesRequest)
                                                            throws AmazonServiceException,
                                                                   AmazonClientException

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

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

定義:

listVerifiedEmailAddresses インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public GetSendStatisticsResult getSendStatistics(GetSendStatisticsRequest getSendStatisticsRequest)
                                          throws AmazonServiceException,
                                                 AmazonClientException

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

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

定義:

getSendStatistics インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public VerifyEmailIdentityResult verifyEmailIdentity(VerifyEmailIdentityRequest verifyEmailIdentityRequest)
                                              throws AmazonServiceException,
                                                     AmazonClientException

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

定義:

verifyEmailIdentity インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public GetIdentityNotificationAttributesResult getIdentityNotificationAttributes(GetIdentityNotificationAttributesRequest getIdentityNotificationAttributesRequest)
                                                                          throws AmazonServiceException,
                                                                                 AmazonClientException

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

定義:

getIdentityNotificationAttributes インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public 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 開発者ガイド をご覧ください。

定義:

verifyDomainDkim インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public 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 開発者ガイド をご覧ください。

定義:

getIdentityDkimAttributes インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public void verifyEmailAddress(VerifyEmailAddressRequest verifyEmailAddressRequest)
                        throws AmazonServiceException,
                               AmazonClientException

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

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

定義:

verifyEmailAddress インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public 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 開発者ガイド の "送信量を管理する" を参照してください。

定義:

sendRawEmail インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public ListIdentitiesResult listIdentities(ListIdentitiesRequest listIdentitiesRequest)
                                    throws AmazonServiceException,
                                           AmazonClientException

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

定義:

listIdentities インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public GetIdentityVerificationAttributesResult getIdentityVerificationAttributes(GetIdentityVerificationAttributesRequest getIdentityVerificationAttributesRequest)
                                                                          throws AmazonServiceException,
                                                                                 AmazonClientException

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

定義:

getIdentityVerificationAttributes インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public 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 開発者ガイド をご覧ください。

定義:

setIdentityDkimEnabled インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public GetSendQuotaResult getSendQuota(GetSendQuotaRequest getSendQuotaRequest)
                                throws AmazonServiceException,
                                       AmazonClientException

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

定義:

getSendQuota インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public SetIdentityFeedbackForwardingEnabledResult setIdentityFeedbackForwardingEnabled(SetIdentityFeedbackForwardingEnabledRequest setIdentityFeedbackForwardingEnabledRequest)
                                                                                throws AmazonServiceException,
                                                                                       AmazonClientException

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

定義:

setIdentityFeedbackForwardingEnabled インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public VerifyDomainIdentityResult verifyDomainIdentity(VerifyDomainIdentityRequest verifyDomainIdentityRequest)
                                                throws AmazonServiceException,
                                                       AmazonClientException

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

定義:

verifyDomainIdentity インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public 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 開発者ガイド の "送信量を管理する" を参照してください。

定義:

sendEmail インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public void deleteVerifiedEmailAddress(DeleteVerifiedEmailAddressRequest deleteVerifiedEmailAddressRequest)
                                throws AmazonServiceException,
                                       AmazonClientException

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

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

定義:

deleteVerifiedEmailAddress インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public SetIdentityNotificationTopicResult setIdentityNotificationTopic(SetIdentityNotificationTopicRequest setIdentityNotificationTopicRequest)
                                                                throws AmazonServiceException,
                                                                       AmazonClientException

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

定義:

setIdentityNotificationTopic インタフェース内 AmazonSimpleEmailService

パラメータ:

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

public ListVerifiedEmailAddressesResult listVerifiedEmailAddresses()
                                                            throws AmazonServiceException,
                                                                   AmazonClientException

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

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

定義:

listVerifiedEmailAddresses インタフェース内 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

public GetSendStatisticsResult getSendStatistics()
                                          throws AmazonServiceException,
                                                 AmazonClientException

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

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

定義:

getSendStatistics インタフェース内 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.

listIdentities

public ListIdentitiesResult listIdentities()
                                    throws AmazonServiceException,
                                           AmazonClientException

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

定義:

listIdentities インタフェース内 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.

getSendQuota

public GetSendQuotaResult getSendQuota()
                                throws AmazonServiceException,
                                       AmazonClientException

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

定義:

getSendQuota インタフェース内 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.

getServiceAbbreviation

protected java.lang.String getServiceAbbreviation()

クラスからコピーされた説明: AmazonWebServiceClient

リージョンによるサービスエンドポイントを特定するために、このサービスに対する 略称を返します

オーバーライド:

getServiceAbbreviation クラス内 AmazonWebServiceClient

関連項目:

ServiceAbbreviations

getCachedResponseMetadata

public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

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

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

定義:

getCachedResponseMetadata インタフェース内 AmazonSimpleEmailService

パラメータ:

request - The originally executed request

戻り値:

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