Amazon SNS 的操作、资源和条件键 - 服务授权参考
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Amazon SNS 的操作、资源和条件键

Amazon SNS(服务前缀:sns)提供以下服务特定的资源、操作和条件上下文键以在 IAM 权限策略中使用。

参考:

Amazon SNS 定义的操作

您可以在 Action 策略语句的 IAM 元素中指定以下操作。可以使用策略授予在 AWS 中执行操作的权限。您在策略中使用一项操作时,通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下,单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。

资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值,您必须在策略语句的 Resource 元素中指定所有资源(“*”)。如果该列包含一种资源类型,则可以在含有该操作的语句中指定该类型的 ARN。必需资源在表中以星号 (*) 表示。如果在使用该操作的语句中指定资源级权限 ARN,则它必须属于该类型。某些操作支持多种资源类型。如果资源类型是可选的(未指示为必需),则可以选择使用一种类型而不使用其他类型。

有关下表中各列的详细信息,请参阅 操作表

操作 描述 访问级别 资源类型(* 为必需) 条件键 相关操作
AddPermission 授予向主题的访问控制策略添加一个语句,允许指定的亚马逊云科技账户完成指定操作的权限 权限管理

topic*

CheckIfPhoneNumberIsOptedOut 授予接受电话号码,并指明电话持有者是否已选择不接收来自您的账户的 SMS 消息的权限 Read
ConfirmSubscription 授予权限,以通过更早的订阅操作来验证发送到终端节点的令牌,以此验证终端节点所有者接收消息的意图 写入

topic*

CreatePlatformApplication 授予权限,以便为设备和移动应用程序可能注册的受支持的推送通知服务(如 APNS 和 GCM)之一创建平台应用程序对象 写入

iam:PassRole

CreatePlatformEndpoint 授予权限,以便在受支持的推送通知服务(如 GCM 和 APNS)之一上为设备和移动应用程序创建终端节点 写入
CreateSMSSandboxPhoneNumber 授予添加目标电话号码并向亚马逊云科技账户的该电话号码发送一次性密码 (OTP) 的权限 写入
CreateTopic 授予创建可向其发布通知的主题的权限 写入

topic*

iam:PassRole

DeleteEndpoint 授予从 Amazon SNS 中删除设备和移动应用程序的终端节点的权限 写入
DeletePlatformApplication 授予针对受支持的推送通知服务之一(如 APNS 和 GCM)删除平台应用程序对象的权限 写入
DeleteSMSSandboxPhoneNumber 授予删除亚马逊云科技账户的已验证或待处理电话号码的权限 写入
DeleteTopic 授予删除主题及其所有订阅的权限 写入

topic*

GetEndpointAttributes 授予为受支持的推送通知服务(如 GCM 和 APNS)之一上的设备检索终端节点属性的权限 Read
GetPlatformApplicationAttributes 授予为受支持的推送通知服务(如 APNS 和 GCM)检索平台应用程序对象属性的权限 Read
GetSMSAttributes 授予从您的账户返回发送 SMS 消息的设置的权限 Read
GetSMSSandboxAccountStatus 授予在目标区域为呼叫账户检索沙箱状态的权限 Read
GetSubscriptionAttributes 授予返回订阅所有属性的权限 Read
GetTopicAttributes 授予返回主题所有属性的权限 Read

topic*

ListEndpointsByPlatformApplication 授予列出受支持的推送通知服务(例如 GCM 和 APNS)中的设备的终端节点和终端节点属性的权限 List
ListOriginationNumbers 授予列出所有原始编号及其元数据的权限 List
ListPhoneNumbersOptedOut 授予返回已退出电话号码的列表的权限,这意味着您无法向这些电话号码发送 SMS 消息 Read
ListPlatformApplications 授予为受支持的推送通知服务(例如 APNS 和 GCM)列出平台应用程序对象的权限 List
ListSMSSandboxPhoneNumbers 授予列出呼叫账户当前待处理和已验证的目标电话号码的权限 List
ListSubscriptions 授予返回请求者订阅列表的权限 List
ListSubscriptionsByTopic 授予返回特定主题订阅列表的权限 List

topic*

ListTagsForResource 授予列出添加到指定 Amazon SNS 主题的所有标签的权限 Read

topic

ListTopics 授予返回请求者主题列表的权限 List
OptInPhoneNumber 授予加入当前已退出的电话号码的权限,这样您便可以继续向该号码发送 SMS 消息 写入
Publish 授予向主题的所有订阅终端节点发送消息的权限 写入

topic*

RemovePermission 授予从主题的访问控制策略中删除语句的权限 权限管理

topic*

SetEndpointAttributes 授予为受支持的推送通知服务(如 GCM 和 APNS)之一上的设备设置终端节点属性的权限 写入
SetPlatformApplicationAttributes 授予为受支持的推送通知服务(如 APNS 和 GCM)设置平台应用程序对象属性的权限 写入

iam:PassRole

SetSMSAttributes 授予设置用于发送 SMS 消息和接收每日 SMS 使用情况报告的默认设置的权限 写入
SetSubscriptionAttributes 授予允许订阅拥有者将主题属性设置为新值的权限 写入
SetTopicAttributes 授予允许主题拥有者将主题属性设置为新值的权限 写入

topic*

iam:PassRole

Subscribe 授予通过向终端节点发送确认消息来准备订阅终端节点的权限 写入

topic*

sns:Endpoint

sns:Protocol

TagResource 授予向指定的 Amazon SNS 主题添加标签的权限 标记

topic

aws:RequestTag/${TagKey}

aws:TagKeys

Unsubscribe 授予删除订阅的权限 写入
UntagResource 授予从 Amazon SNS 主题中删除标签的权限 标记

topic

aws:RequestTag/${TagKey}

aws:TagKeys

VerifySMSSandboxPhoneNumber 授予使用亚马逊云科技账户的一次性密码 (OTP) 验证目标电话号码的权限 写入

Amazon SNS 定义的资源类型

以下资源类型是由该服务定义的,可以在 IAM 权限策略语句的 Resource 元素中使用这些资源类型。操作表中的每个操作都标识了可以使用该操作指定的资源类型。您也可以在策略中包含条件键,从而定义资源类型。这些键显示在表的最后一列。有关下表中各列的详细信息,请参阅 资源类型表

资源类型 ARN 条件键
topic arn:${Partition}:sns:${Region}:${Account}:${TopicName}

Amazon SNS 的条件键

Amazon SNS 定义以下可以在 IAM 策略的 Condition 元素中使用的条件键。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息,请参阅 条件键表

要查看适用于所有服务的全局条件键,请参阅可用的全局条件键

条件键 描述 类型
aws:RequestTag/${TagKey} 根据来自请求的标签筛选访问 字符串
aws:TagKeys 根据来自请求键的标签筛选访问 字符串
sns:Endpoint 根据来自订阅请求或之前已确认订阅的 URL、电子邮件地址或 ARN 筛选访问 字符串
sns:Protocol 根据来自订阅请求或之前已确认订阅的协议值筛选访问 字符串