本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Amazon Simple Email Service v2 的操作、资源和条件键
Amazon Simple Email Service v2(服务前缀:ses
)提供以下特定于服务的资源、操作和条件上下文密钥,用于IAM权限策略。
参考:
-
了解如何配置该服务。
-
查看此服务可用的API操作列表。
-
了解如何使用IAM权限策略保护此服务及其资源。
主题
Amazon Simple Email Service v2 定义的操作
您可以在IAM策略声明的Action
元素中指定以下操作。可以使用策略授予在 AWS中执行操作的权限。当您在策略中使用操作时,通常会允许或拒绝访问具有相同名称的API操作或CLI命令。但在某些情况下,单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。
操作表的资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值,您必须在策略语句的 Resource
元素中指定策略应用的所有资源(“*”)。如果该列包含资源类型,则可以在带有该操作ARN的语句中指定该类型的资源类型。如果操作具有一个或多个必需资源,则调用方必须具有使用这些资源来使用该操作的权限。必需资源在表中以星号 (*) 表示。如果您使用IAM策略中的Resource
元素限制资源访问权限,则必须为每种必需的资源类型包含ARN或模式。某些操作支持多种资源类型。如果资源类型是可选的(未指示为必需),则可以选择使用一种可选资源类型。
操作表的条件键列包括可以在策略语句的 Condition
元素中指定的键。有关与服务资源关联的条件键的更多信息,请参阅资源类型表的条件键列。
注意
资源条件键在资源类型表中列出。您可以在操作表的资源类型(* 为必需)列中找到应用于某项操作的资源类型的链接。资源类型表中的资源类型包括条件密钥列,这是应用于操作表中操作的资源条件键。
有关下表中各列的详细信息,请参阅操作表。
操作 | 描述 | 访问级别 | 资源类型(* 为必需) | 条件键 | 相关操作 |
---|---|---|---|---|---|
BatchGetMetricData | 授予获取活动指标数据的权限 | 读取 | |||
CancelExportJob | 授予取消导出作业的权限 | 写入 | |||
CreateConfigurationSet | 授予创建新配置集的权限 | Write | |||
CreateConfigurationSetEventDestination | 授予以下权限:创建配置集事件目标 | Write | |||
CreateContact | 授予创建联系人的权限 | Write | |||
CreateContactList | 授予创建联系人列表的权限 | Write | |||
CreateCustomVerificationEmailTemplate | 授予以下权限:创建新的自定义验证电子邮件模板 | Write | |||
CreateDedicatedIpPool | 授予以下权限:创建新的专用 IP 地址池 | Write | |||
CreateDeliverabilityTestReport | 授予以下权限:创建新的预测性收件箱放置测试 | Write | |||
CreateEmailIdentity | 授予开始验证电子邮件身份过程的权限 | Write | |||
CreateEmailIdentityPolicy | 授予以下权限:为给定身份创建指定的发送授权策略 | Permissions management | |||
CreateEmailTemplate | 授予创建电子邮件模板的权限 | 写入 | |||
CreateExportJob | 授予创建导出作业的权限 | 写入 | |||
CreateImportJob | 授予为数据目标创建导入作业的权限 | Write | |||
DeleteConfigurationSet | 授予删除现有配置集的权限 | Write | |||
DeleteConfigurationSetEventDestination | 授予删除事件目标的权限 | Write | |||
DeleteContact | 授予从联系人列表中删除联系人的权限 | Write | |||
DeleteContactList | 授予删除联系人列表中所有联系人的权限 | Write | |||
DeleteCustomVerificationEmailTemplate | 授予删除现有自定义验证电子邮件模板的权限 | Write | |||
DeleteDedicatedIpPool | 授予删除专用 IP 池的权限 | Write | |||
DeleteEmailIdentity | 授予删除电子邮件身份的权限 | Write | |||
DeleteEmailIdentityPolicy | 授予以下权限:删除给定身份(电子邮件地址或域)的指定发送授权策略 | Permissions management | |||
DeleteEmailTemplate | 授予删除电子邮件模板的权限 | Write | |||
DeleteSuppressedDestination | 授予从账户的黑名单中删除电子邮件地址的权限 | Write | |||
GetAccount | 授予以下权限:获取有关账户电子邮件发送状态和功能的信息 | Read | |||
GetBlacklistReports | 授予以下权限:检索显示您的专用 IP 地址或跟踪域的拒绝列表 | Read | |||
GetConfigurationSet | 授予以下权限:获取有关现有配置集的信息 | Read | |||
GetConfigurationSetEventDestinations | 授予以下权限:检索与配置集关联的事件目标列表 | Read | |||
GetContact | 授予从联系人列表返回联系人的权限 | Read | |||
GetContactList | 授予返回联系人列表元数据的权限 | Read | |||
GetCustomVerificationEmailTemplate | 授予以下权限:针对指定的模板名称返回自定义电子邮件验证模板 | Read | |||
GetDedicatedIp | 授予以下权限:获取专用 IP 地址的信息 | 读取 | |||
GetDedicatedIpPool | 授予权限以获取有关专用 IP 池的信息 | 读取 | |||
GetDedicatedIps | 授予以下权限:为专用 IP 地址列出专用 IP 池 | Read | |||
GetDeliverabilityDashboardOptions | 授予以下权限:获取送达率控制面板的状态 | Read | |||
GetDeliverabilityTestReport | 授予以下权限:检索预测性收件箱放置测试的结果 | Read | |||
GetDomainDeliverabilityCampaign | 授予以下权限:检索特定市场活动的所有投放率数据 | Read | |||
GetDomainStatisticsReport | 授予以下权限:检索用于发送电子邮件的域的收件箱放置和互动率 | Read | |||
GetEmailIdentity | 授予以下权限:获取有关指定身份的信息 | Read | |||
GetEmailIdentityPolicies | 授予以下权限:返回请求的用于给定身份(电子邮件地址或域)的发送授权策略 | 读取 | |||
GetEmailTemplate | 授予返回模板对象的权限,该对象包括您指定模板的主题行、HTML部分和文本部分 | 读取 | |||
GetExportJob | 授予获取有关导出作业的信息的权限 | 读取 | |||
GetImportJob | 授予以下权限:提供有关导入作业的信息 | 读取 | |||
GetMessageInsights | 授予提供有关消息的见解的权限 | 读取 | |||
GetSuppressedDestination | 授予以下权限:检索有关账户黑名单中特定电子邮件地址的信息 | Read | |||
ListConfigurationSets | 授予以下权限:列出账户的所有配置集 | List | |||
ListContactLists | 授予以下权限:列出可用于账户的所有联系人列表 | List | |||
ListContacts | 授予以下权限:列出特定联系人列表中的联系人 | List | |||
ListCustomVerificationEmailTemplates | 授予以下权限:列出账户的所有现有自定义验证电子邮件模板 | List | |||
ListDedicatedIpPools | 授予以下权限:列出账户的所有专用 IP 池 | List | |||
ListDeliverabilityTestReports | 授予以下权限:检索为账户执行的预测性收件箱放置测试列表(无论状态如何) | List | |||
ListDomainDeliverabilityCampaigns | 授予以下权限:在指定时间范围内使用特定域发送电子邮件的市场活动列出送达率数据 | Read | |||
ListEmailIdentities | 授予以下权限:列出账户的电子邮件身份 | List | |||
ListEmailTemplates | 授予以下权限:列出账户的所有电子邮件模板 | 列出 | |||
ListExportJobs | 授予列出账户的所有导出作业的权限 | 列出 | |||
ListImportJobs | 授予以下权限:列出账户的所有导入作业 | 列出 | |||
ListRecommendations | 授予为您的账户列出建议的权限 | 读取 | |||
ListSuppressedDestinations | 授予以下权限:列出帐户黑名单中的电子邮件地址 | Read | |||
ListTagsForResource | 授予以下权限:检索与账户的特定资源关联的标签(键和值)的列表 | Read | |||
PutAccountDedicatedIpWarmupAttributes | 授予以下权限:为专用 IP 地址启用或禁用自动预热功能 | Write | |||
PutAccountDetails | 授予更新账户详细信息的权限 | Write | |||
PutAccountSendingAttributes | 授予以下权限:启用或禁用为您的账户发送电子邮件的功能 | Write | |||
PutAccountSuppressionAttributes | 授予更改账户级黑名单设置的权限 | 写入 | |||
PutAccountVdmAttributes | 授予更改账户设置VDM的权限 | 写入 | |||
PutConfigurationSetDeliveryOptions | 授予将配置集与专用 IP 池相关联的权限 | Write | |||
PutConfigurationSetReputationOptions | 授予以下权限:为使用特定配置集发送的电子邮件启用或禁用声誉指标收集 | Write | |||
PutConfigurationSetSendingOptions | 授予以下权限:为使用特定配置集的消息启用或禁用电子邮件发送 | Write | |||
PutConfigurationSetSuppressionOptions | 授予以下权限:指定特定配置集的账户黑名单首选项 | Write | |||
PutConfigurationSetTrackingOptions | 授予以下权限:为特定配置集指定用于在发送的电子邮件中打开和单击跟踪元素的自定义域 | 写入 | |||
PutConfigurationSetVdmOptions | 授予权限以覆盖特定配置集的账户级别VDM设置 | 写入 | |||
PutDedicatedIpInPool | 授予以下权限:将专用 IP 地址移至现有专用 IP 池 | 写入 | |||
PutDedicatedIpPoolScalingAttributes | 授予将专用 IP 池从标准转换为托管的权限 | 写入 | |||
PutDedicatedIpWarmupAttributes | 授予放置专用 IP 热身属性的权限 | Write | |||
PutDeliverabilityDashboardOption | 授予启用或禁用送达率控制面板的权限 | Write | |||
PutEmailIdentityConfigurationSetAttributes | 授予将配置集与电子邮件身份关联的权限 | 写入 | |||
PutEmailIdentityDkimAttributes | 授予启用或禁用电子邮件DKIM身份验证的权限 | 写入 | |||
PutEmailIdentityDkimSigningAttributes | 授予配置或更改电子邮件域DKIM身份验证设置的权限 | 写入 | |||
PutEmailIdentityFeedbackAttributes | 授予以下其权限:为电子邮件身份启用或禁用反馈转发 | 写入 | |||
PutEmailIdentityMailFromAttributes | 授予启用或禁用电子邮件身份的自定义MAILFROM域配置的权限 | 写入 | |||
PutSuppressedDestination | 授予向黑名单添加电子邮件地址的权限 | Write | |||
SendBulkEmail | 授予以下权限:编写发往多个目标的电子邮件 | Write | |||
SendCustomVerificationEmail | 授予以下权限:向身份列表添加电子邮件地址并尝试验证该地址 | Write | |||
SendEmail | 授予发送电子邮件消息的权限 | Write | |||
TagResource | 授予以下权限:将一个或多个标签(键和值)添加到指定的资源中 | 标记 | |||
TestRenderEmailTemplate | 在提供模板和一组替换数据时,授予创建电子邮件MIME内容预览的权限 | 写入 | |||
UntagResource | 授予以下权限:从指定的资源中删除一个或多个标签(键和值) | Tagging | |||
UpdateConfigurationSetEventDestination | 授予以下权限:更新配置集的事件目标的配置 | Write | |||
UpdateContact | 授予以下权限:更新联系人的列表首选项 | Write | |||
UpdateContactList | 授予更新联系人列表元数据的权限 | Write | |||
UpdateCustomVerificationEmailTemplate | 授予更新现有自定义验证电子邮件模板的权限 | Write | |||
UpdateEmailIdentityPolicy | 授予以下权限:更新给定身份(电子邮件地址或域)的指定发送授权策略 | Permissions management | |||
UpdateEmailTemplate | 授予更新电子邮件模板的权限 | Write | |||
Amazon Simple Email Service v2 定义的资源类型
以下资源类型由此服务定义,可以在IAM权限策略语句的Resource
元素中使用。操作表中的每个操作指定了可以使用该操作指定的资源类型。您也可以在策略中包含条件键,从而定义资源类型。这些键显示在资源类型表的最后一列。有关下表中各列的详细信息,请参阅资源类型表。
资源类型 | ARN | 条件键 |
---|---|---|
configuration-set |
arn:${Partition}:ses:${Region}:${Account}:configuration-set/${ConfigurationSetName}
|
|
contact-list |
arn:${Partition}:ses:${Region}:${Account}:contact-list/${ContactListName}
|
|
custom-verification-email-template |
arn:${Partition}:ses:${Region}:${Account}:custom-verification-email-template/${TemplateName}
|
|
dedicated-ip-pool |
arn:${Partition}:ses:${Region}:${Account}:dedicated-ip-pool/${DedicatedIPPool}
|
|
deliverability-test-report |
arn:${Partition}:ses:${Region}:${Account}:deliverability-test-report/${ReportId}
|
|
export-job |
arn:${Partition}:ses:${Region}:${Account}:export-job/${ExportJobId}
|
|
identity |
arn:${Partition}:ses:${Region}:${Account}:identity/${IdentityName}
|
|
import-job |
arn:${Partition}:ses:${Region}:${Account}:import-job/${ImportJobId}
|
|
template |
arn:${Partition}:ses:${Region}:${Account}:template/${TemplateName}
|
Amazon Simple Email Service v2 的条件键
Amazon Simple Email Service v2 定义了可在IAM策略Condition
元素中使用的以下条件键。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息,请参阅条件键表。
要查看适用于所有服务的全局条件键,请参阅可用的全局条件键。
条件键 | 描述 | 类型 |
---|---|---|
aws:RequestTag/${TagKey} | 根据在请求中是否具有标签键值对来筛选访问权限 | String |
aws:ResourceTag/${TagKey} | 按附加到资源的标签键值对筛选操作 | String |
aws:TagKeys | 根据在请求中是否具有标签键来筛选访问 | ArrayOfString |
ses:ApiVersion | 按SESAPI版本筛选访问权限 | String |
ses:ExportSourceType | 按导出源类型筛选访问权限 | String |
ses:FeedbackAddress | 按“Return-Path”地址筛选访问权限,该地址指定退回邮件和投诉通过电子邮件反馈转发发送到其中的地址。 | String |
ses:FromAddress | 按邮件的“发件人”地址筛选访问权限 | String |
ses:FromDisplayName | 按用作邮件显示名称的“发件人”地址筛选访问权限 | String |
ses:Recipients | 按邮件的收件人地址(包括 “收件人”、“抄送” 和 “BCC” 地址)筛选访问权限 | ArrayOfString |