Amazon Pinpoint Email Service のアクション、リソース、および条件キー

Amazon Pinpoint Email Service (サービスプレフィックス: ses) では、IAM アクセス許可ポリシーで使用できるように、以下のサービス固有のリソース、アクション、条件コンテキストキーが用意されています。

参照:

• このサービスを設定する方法について説明します。

• このサービスで使用可能な API オペレーションのリストを表示します。

• IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法を学びます。

Amazon Pinpoint Email Service で定義されるアクション

IAM ポリシーステートメントの Action エレメントでは、以下のアクションを指定できます。ポリシーを使用して、AWS でオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合は、通常、同じ名前の API オペレーションまたは CLI コマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

[アクション] テーブルの [リソースタイプ] 列は、各アクションがリソースレベルの許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource 要素で、ポリシーが適用されるすべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれる場合、そのアクションを含むステートメントでそのタイプの ARN を指定できます。アクションで 1 つ以上のリソースが必須となっている場合、呼び出し元には、それらのリソースを伴うアクションを使用するための許可が付与されている必要があります。必須リソースは、アスタリスク (*) でテーブルに示されています。IAM ポリシーの Resource 要素でリソースアクセスを制限する場合は、必要なリソースタイプごとに ARN またはパターンを含める必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、オプションのリソースタイプのいずれかを使用することを選択できます。

[アクション] テーブルの [条件キー] 列には、ポリシーステートメントの Condition 要素で指定できるキーが含まれます。サービスのリソースに関連付けられている条件キーの詳細については、[リソースタイプ] テーブルの [条件キー] 列を参照してください。

注記

リソース条件キーは、リソースタイプテーブルに一覧表示されています。アクションに適用されるリソースタイプへのリンクは、[アクション] テーブルの [リソースタイプ (* 必須)] 列にあります。[リソースタイプ] テーブルのリソースタイプには、[アクション] テーブルのアクションに適用されるリソース条件キーである、[条件キー] 列が含まれています。

以下の表の列の詳細については、「アクションテーブル」を参照してください。

アクション	説明	アクセスレベル	リソースタイプ (* 必須)	条件キー	依存アクション
CreateConfigurationSet	設定セットを作成する許可を付与	書き込み		ses:ApiVersion aws:TagKeys aws:RequestTag/${TagKey}
CreateConfigurationSetEventDestination	設定セットイベントの宛先を作成する許可を付与	書き込み	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
CreateDedicatedIpPool	専用 IP アドレスの新しいプールを作成する許可を付与	書き込み		ses:ApiVersion aws:TagKeys aws:RequestTag/${TagKey}
CreateDeliverabilityTestReport	新しい予測受信箱配置テストを作成する許可を付与	書き込み	identity*
				ses:ApiVersion aws:TagKeys aws:RequestTag/${TagKey}
CreateEmailIdentity	E メール ID の検証プロセスを開始する許可を付与	書き込み		ses:ApiVersion aws:TagKeys aws:RequestTag/${TagKey}
DeleteConfigurationSet	既存の設定セットを削除する許可を付与	書き込み	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
DeleteConfigurationSetEventDestination	イベントの送信先を削除するアクセス権限を付与します	書き込み	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
DeleteDedicatedIpPool	専用 IP プールを削除する許可を付与	書き込み	dedicated-ip-pool*
				ses:ApiVersion aws:ResourceTag/${TagKey}
DeleteEmailIdentity	以前に検証した E メール ID を削除する許可を付与	書き込み	identity*
				ses:ApiVersion aws:ResourceTag/${TagKey}
GetAccount	E メールの送信ステータスと機能に関する情報を取得するためのアクセス許可を付与します	読み込み		ses:ApiVersion
GetBlacklistReports	専用 IP アドレスが表示される拒否リストの一覧を取得するためのアクセス許可を付与します	読み込み		ses:ApiVersion
GetConfigurationSet	既存の設定セットに関する情報を取得するためのアクセス許可を付与します	読み込み	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
GetConfigurationSetEventDestinations	設定セットに関連付けられているイベント送信先のリストを取得する許可を付与	読み込み	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
GetDedicatedIp	専用 IP アドレスに関する情報を取得するためのアクセス許可を付与します	読み込み		ses:ApiVersion
GetDedicatedIps	アカウントに関連付けられている専用 IP アドレスを一覧表示する許可を付与	読み込み	dedicated-ip-pool*
				ses:ApiVersion aws:ResourceTag/${TagKey}
GetDeliverabilityDashboardOptions	配信性能ダッシュボードのステータスを取得するためのアクセス許可を付与します	読み込み		ses:ApiVersion
GetDeliverabilityTestReport	受信箱配置の予測テストの結果を取得するためのアクセス許可を付与します	読み込み	deliverability-test-report*
				ses:ApiVersion aws:ResourceTag/${TagKey}
GetDomainDeliverabilityCampaign	特定のキャンペーンのすべての配信性能データを取得するためのアクセス許可を付与します	読み込み		ses:ApiVersion
GetDomainStatisticsReport	E メールの送信に使用するドメインの受信箱配置とエンゲージメント率を取得する許可を付与	読み込み	identity*
				ses:ApiVersion aws:ResourceTag/${TagKey}
GetEmailIdentity	アカウントに関連付けられた特定の ID に関する情報を取得するためのアクセス許可を付与します	読み込み	identity*
				ses:ApiVersion aws:ResourceTag/${TagKey}
ListConfigurationSets	アカウントに関連付けられているすべての設定セットを一覧表示する許可を付与	リスト		ses:ApiVersion
ListDedicatedIpPools	アカウント内に存在するすべての専用 IP プールを一覧表示する許可を付与	リスト		ses:ApiVersion
ListDeliverabilityTestReports	ステータスに関係なく、実行した受信箱配置の予測テストのリストを取得する許可を付与	リスト		ses:ApiVersion
ListDomainDeliverabilityCampaigns	指定した期間内に特定のドメインを使用して E メールを送信したすべてのキャンペーンの配信性能データを取得するためのアクセス許可を付与します	読み込み		ses:ApiVersion
ListEmailIdentities	アカウントに関連付けられているすべての E メール ID の一覧を表示する許可を付与	リスト		ses:ApiVersion
ListTagsForResource	特定のリソースに関連付けられているタグ (キーと値) のリストを取得する許可を付与	読み込み	configuration-set
			dedicated-ip-pool
			deliverability-test-report
			identity
				ses:ApiVersion
PutAccountDedicatedIpWarmupAttributes	専用 IP アドレスの自動ウォームアップ機能を有効または無効にする許可を付与	書き込み		ses:ApiVersion
PutAccountSendingAttributes	アカウントの E メール送信機能を有効または無効にする許可を付与	書き込み		ses:ApiVersion
PutConfigurationSetDeliveryOptions	設定セットを専用 IP プールに関連付けるアクセス許可を付与します	書き込み	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
PutConfigurationSetReputationOptions	特定の設定セットを使用して送信する E メールの評価メトリクスの収集を有効または無効にする許可を付与	書き込み	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
PutConfigurationSetSendingOptions	特定の設定セットを使用するメッセージの E メール送信を有効または無効にする許可を付与	書き込み	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
PutConfigurationSetTrackingOptions	特定の設定セットを使用して送信する E メールの開封とクリックの追跡要素に使用するカスタムドメインを指定する許可を付与	書き込み	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
PutDedicatedIpInPool	専用 IP アドレスを既存の専用 IP プールに移動する許可を付与	書き込み	dedicated-ip-pool*
				ses:ApiVersion aws:ResourceTag/${TagKey}
PutDedicatedIpWarmupAttributes	専用 IP ウォームアップ属性を有効にする許可を付与	書き込み		ses:ApiVersion
PutDeliverabilityDashboardOption	配信性能ダッシュボードを有効または無効にする許可を付与	書き込み		ses:ApiVersion
PutEmailIdentityDkimAttributes	E メール ID の DKIM 認証を有効または無効にする許可を付与	書き込み	identity*
				ses:ApiVersion aws:ResourceTag/${TagKey}
PutEmailIdentityFeedbackAttributes	ID のフィードバック転送を有効または無効にする許可を付与	書き込み	identity*
				ses:ApiVersion aws:ResourceTag/${TagKey}
PutEmailIdentityMailFromAttributes	E メール ID のカスタム MAIL FROM ドメイン設定を有効または無効にする許可を付与	書き込み	identity*
				ses:ApiVersion aws:ResourceTag/${TagKey}
SendEmail	E メールメッセージを送信する許可を付与	書き込み	identity*
				ses:ApiVersion ses:FeedbackAddress ses:FromAddress ses:FromDisplayName ses:Recipients
TagResource	指定したリソースに 1 つ以上のタグ (キーと値) を追加する許可を付与	タグ付け	configuration-set
			dedicated-ip-pool
			deliverability-test-report
			identity
				ses:ApiVersion aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	指定したリソースから 1 つ以上のタグ (キーと値) を削除する許可を付与	タグ付け	configuration-set
			dedicated-ip-pool
			deliverability-test-report
			identity
				ses:ApiVersion aws:TagKeys
UpdateConfigurationSetEventDestination	設定セットのイベント送信先の設定を更新する許可を付与	書き込み	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}

Amazon Pinpoint Email Service で定義されるリソースタイプ

以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource エレメントで使用できます。アクションテーブルの各アクションは、そのアクションで指定できるリソースタイプを示しています。リソースタイプは、ポリシーに含めることができる条件キーを定義することもできます。これらのキーは、[リソースタイプ] テーブルの最後の列に表示されます。以下の表の列の詳細については、「リソースタイプテーブル」を参照してください。

リソースタイプ	ARN	条件キー
configuration-set	arn:${Partition}:ses:${Region}:${Account}:configuration-set/${ConfigurationSetName}	aws:ResourceTag/${TagKey}
dedicated-ip-pool	arn:${Partition}:ses:${Region}:${Account}:dedicated-ip-pool/${DedicatedIPPool}	aws:ResourceTag/${TagKey}
deliverability-test-report	arn:${Partition}:ses:${Region}:${Account}:deliverability-test-report/${ReportId}	aws:ResourceTag/${TagKey}
identity	arn:${Partition}:ses:${Region}:${Account}:identity/${IdentityName}	aws:ResourceTag/${TagKey}

Amazon Pinpoint Email Service の条件キー

Amazon Pinpoint Email Service は、IAM ポリシーの Condition 要素で使用できる以下の条件キーを定義します。これらのキーを使用して、ポリシーステートメントが適用される条件をさらに絞り込むことができます。以下の表の列の詳細については、「条件キーテーブル」を参照してください。

すべてのサービスで使用できるグローバル条件キーを確認するには、「使用できるグローバル条件キー」を参照してください。

条件キー	説明	タイプ
aws:RequestTag/${TagKey}	リクエスト内のタグキーと値のペアのプレゼンスに基づいてアクションをフィルタリングします	文字列
aws:ResourceTag/${TagKey}	リソースにアタッチされているタグキーと値のペアに基づいてアクションをフィルタリングします	文字列
aws:TagKeys	リクエスト内のタグキーのプレゼンスに基づいてアクションをフィルタリングします	ArrayOfString
ses:ApiVersion	SES API バージョンに基づいてアクションをフィルタリング	文字列
ses:FeedbackAddress	E メールフィードバック転送によって送信されたバウンスおよび苦情の場所を指定する「リターンパス」アドレスに基づくアクションをフィルタリングします	文字列
ses:FromAddress	メッセージの「From」アドレスに基づいてアクションをフィルタリングします	文字列
ses:FromDisplayName	メッセージの表示名として使用される「From」アドレスに基づいてアクションをフィルタリングします	文字列
ses:Recipients	「To」、「CC」、「BCC」アドレスを含むメッセージの受取人アドレスに基づくアクションをフィルタリングします	ArrayOfString