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 | 設定セットを作成する許可を付与 | 書き込み | |||
CreateConfigurationSetEventDestination | 設定セットイベントの宛先を作成する許可を付与 | 書き込み | |||
CreateDedicatedIpPool | 専用 IP アドレスの新しいプールを作成する許可を付与 | 書き込み | |||
CreateDeliverabilityTestReport | 新しい予測受信箱配置テストを作成する許可を付与 | 書き込み | |||
CreateEmailIdentity | E メール ID の検証プロセスを開始する許可を付与 | 書き込み | |||
DeleteConfigurationSet | 既存の設定セットを削除する許可を付与 | 書き込み | |||
DeleteConfigurationSetEventDestination | イベントの送信先を削除するアクセス権限を付与します | 書き込み | |||
DeleteDedicatedIpPool | 専用 IP プールを削除する許可を付与 | 書き込み | |||
DeleteEmailIdentity | 以前に検証した E メール ID を削除する許可を付与 | 書き込み | |||
GetAccount | E メールの送信ステータスと機能に関する情報を取得するためのアクセス許可を付与します | 読み込み | |||
GetBlacklistReports | 専用 IP アドレスが表示される拒否リストの一覧を取得するためのアクセス許可を付与します | 読み込み | |||
GetConfigurationSet | 既存の設定セットに関する情報を取得するためのアクセス許可を付与します | 読み込み | |||
GetConfigurationSetEventDestinations | 設定セットに関連付けられているイベント送信先のリストを取得する許可を付与 | 読み込み | |||
GetDedicatedIp | 専用 IP アドレスに関する情報を取得するためのアクセス許可を付与します | 読み込み | |||
GetDedicatedIps | アカウントに関連付けられている専用 IP アドレスを一覧表示する許可を付与 | 読み込み | |||
GetDeliverabilityDashboardOptions | 配信性能ダッシュボードのステータスを取得するためのアクセス許可を付与します | 読み込み | |||
GetDeliverabilityTestReport | 受信箱配置の予測テストの結果を取得するためのアクセス許可を付与します | 読み込み | |||
GetDomainDeliverabilityCampaign | 特定のキャンペーンのすべての配信性能データを取得するためのアクセス許可を付与します | 読み込み | |||
GetDomainStatisticsReport | E メールの送信に使用するドメインの受信箱配置とエンゲージメント率を取得する許可を付与 | 読み込み | |||
GetEmailIdentity | アカウントに関連付けられた特定の ID に関する情報を取得するためのアクセス許可を付与します | 読み込み | |||
ListConfigurationSets | アカウントに関連付けられているすべての設定セットを一覧表示する許可を付与 | リスト | |||
ListDedicatedIpPools | アカウント内に存在するすべての専用 IP プールを一覧表示する許可を付与 | リスト | |||
ListDeliverabilityTestReports | ステータスに関係なく、実行した受信箱配置の予測テストのリストを取得する許可を付与 | リスト | |||
ListDomainDeliverabilityCampaigns | 指定した期間内に特定のドメインを使用して E メールを送信したすべてのキャンペーンの配信性能データを取得するためのアクセス許可を付与します | 読み込み | |||
ListEmailIdentities | アカウントに関連付けられているすべての E メール ID の一覧を表示する許可を付与 | リスト | |||
ListTagsForResource | 特定のリソースに関連付けられているタグ (キーと値) のリストを取得する許可を付与 | 読み込み | |||
PutAccountDedicatedIpWarmupAttributes | 専用 IP アドレスの自動ウォームアップ機能を有効または無効にする許可を付与 | 書き込み | |||
PutAccountSendingAttributes | アカウントの E メール送信機能を有効または無効にする許可を付与 | 書き込み | |||
PutConfigurationSetDeliveryOptions | 設定セットを専用 IP プールに関連付けるアクセス許可を付与します | 書き込み | |||
PutConfigurationSetReputationOptions | 特定の設定セットを使用して送信する E メールの評価メトリクスの収集を有効または無効にする許可を付与 | 書き込み | |||
PutConfigurationSetSendingOptions | 特定の設定セットを使用するメッセージの E メール送信を有効または無効にする許可を付与 | 書き込み | |||
PutConfigurationSetTrackingOptions | 特定の設定セットを使用して送信する E メールの開封とクリックの追跡要素に使用するカスタムドメインを指定する許可を付与 | 書き込み | |||
PutDedicatedIpInPool | 専用 IP アドレスを既存の専用 IP プールに移動する許可を付与 | 書き込み | |||
PutDedicatedIpWarmupAttributes | 専用 IP ウォームアップ属性を有効にする許可を付与 | 書き込み | |||
PutDeliverabilityDashboardOption | 配信性能ダッシュボードを有効または無効にする許可を付与 | 書き込み | |||
PutEmailIdentityDkimAttributes | E メール ID の DKIM 認証を有効または無効にする許可を付与 | 書き込み | |||
PutEmailIdentityFeedbackAttributes | ID のフィードバック転送を有効または無効にする許可を付与 | 書き込み | |||
PutEmailIdentityMailFromAttributes | E メール ID のカスタム MAIL FROM ドメイン設定を有効または無効にする許可を付与 | 書き込み | |||
SendEmail | E メールメッセージを送信する許可を付与 | 書き込み | |||
TagResource | 指定したリソースに 1 つ以上のタグ (キーと値) を追加する許可を付与 | タグ付け | |||
UntagResource | 指定したリソースから 1 つ以上のタグ (キーと値) を削除する許可を付与 | タグ付け | |||
UpdateConfigurationSetEventDestination | 設定セットのイベント送信先の設定を更新する許可を付与 | 書き込み | |||
Amazon Pinpoint Email Service で定義されるリソースタイプ
以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource
エレメントで使用できます。アクションテーブルの各アクションは、そのアクションで指定できるリソースタイプを示しています。リソースタイプは、ポリシーに含めることができる条件キーを定義することもできます。これらのキーは、[リソースタイプ] テーブルの最後の列に表示されます。以下の表の列の詳細については、「リソースタイプテーブル」を参照してください。
リソースタイプ | ARN | 条件キー |
---|---|---|
configuration-set |
arn:${Partition}:ses:${Region}:${Account}:configuration-set/${ConfigurationSetName}
|
|
dedicated-ip-pool |
arn:${Partition}:ses:${Region}:${Account}:dedicated-ip-pool/${DedicatedIPPool}
|
|
deliverability-test-report |
arn:${Partition}:ses:${Region}:${Account}:deliverability-test-report/${ReportId}
|
|
identity |
arn:${Partition}:ses:${Region}:${Account}:identity/${IdentityName}
|
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 |