Amazon SNS 的動作、資源和條件索引鍵

Amazon SNS (服務字首：sns) 提供可用於 IAM 許可政策的下列服務特定資源、動作和條件內容金鑰。

參考資料：

• 了解如何設定此服務。

• 檢視可供此服務使用的 API 操作清單。

• 了解如何使用 IAM 許可政策來保護此服務及其資源。

Amazon SNS 定義的動作

您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS 中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果此欄包含資源類型，則您可以在包含該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，發起人必須具有將動作與這些資源搭配使用的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。

「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。

注意

資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊，請參閱動作表。

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
AddPermission	准許將陳述式新增至主題的存取控制政策，以允許指定的 AWS 帳戶存取指定的動作	許可管理	topic*
CheckIfPhoneNumberIsOptedOut	准許接受電話號碼，並指出電話持有者是否已選擇不接收您的帳戶發出的簡訊	讀取
ConfirmSubscription	准許驗證先前的「訂閱」動作傳送到端點的符記有效，以確認端點擁有者想要接收訊息	寫入	topic*
CreatePlatformApplication	針對裝置和行動應用程式可能註冊的其中一個支援的推送通知服務 (例如 APNS 和 GCM)，准許建立平台應用程式物件	寫入			iam:PassRole
CreatePlatformEndpoint	針對其中一個支援的推送通知服務 (例如 GCM 和 APNS) 上的裝置和行動應用程式，准許建立端點	寫入
CreateSMSSandboxPhoneNumber	准許為 AWS 帳戶 新增目的地電話號碼，並將一次性密碼 (OTP) 傳送至該電話號碼	寫入
CreateTopic	准許建立可發佈通知的主題	寫入	topic*		iam:PassRole
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteEndpoint	准許從 Amazon SNS 刪除裝置和行動應用程式的端點	寫入
DeletePlatformApplication	針對其中一個支援的推送通知服務 (例如 APNS 和 GCM)，准許刪除平台應用程式物件	寫入
DeleteSMSSandboxPhoneNumber	准許刪除 AWS 帳戶 已驗證或待處理的電話號碼	寫入
DeleteTopic	准許刪除主題及其所有訂閱	寫入	topic*
GetDataProtectionPolicy	准許傳回主題的資料保護政策	讀取	topic*
GetEndpointAttributes	針對其中一個支援的推送通知服務 (例如 GCM 和 APNS) 上的裝置，准許擷取端點屬性	讀取
GetPlatformApplicationAttributes	針對支援的推送通知服務 (例如 APNS 和 GCM)，准許擷取平台應用程式物件的屬性	讀取
GetSMSAttributes	准許從您的帳戶傳回 SMS 訊息傳送的設定	讀取
GetSMSSandboxAccountStatus	准許擷取目標區域中呼叫帳戶的沙盒狀態	讀取
GetSubscriptionAttributes	准許傳回訂閱的所有屬性	讀取
GetTopicAttributes	准許傳回主題的所有屬性	讀取	topic*
ListEndpointsByPlatformApplication	針對支援的推送通知服務 (例如 GCM 和 APNS) 中的裝置，准許列出端點和端點屬性	列出
ListOriginationNumbers	准許列出所有原始編號及其中繼資料	列出
ListPhoneNumbersOptedOut	准許傳回已選擇退出的電話號碼清單，表示您無法傳送簡訊到這些號碼	讀取
ListPlatformApplications	准許列出支援的推送通知服務 (例如 APNS 和 GCM) 的平台應用程式物件	列出
ListSMSSandboxPhoneNumbers	准許列出呼叫帳戶目前的待處理和已驗證目的地電話號碼	列出
ListSubscriptions	准許傳回請求者的訂閱清單	列出
ListSubscriptionsByTopic	准許傳回訂閱清單至特定主題	列出	topic*
ListTagsForResource	准許列出新增至指定 Amazon SNS 主題的所有標籤	讀取	topic
ListTopics	准許傳回請求者主題的清單	列出
OptInPhoneNumber	准許選擇加入目前已選擇退出的電話號碼，讓您可以繼續將簡訊傳送到此號碼	寫入
Publish	准許傳送訊息給主題的所有訂閱端點	寫入	topic*
PutDataProtectionPolicy	准許允許主題擁有者設定資料保護政策	寫入	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	准許透過 AWS 帳戶 的一次性密碼 (OTP) 驗證目的地電話號碼	寫入

Amazon SNS 定義的資源類型

此服務會定義下列資源類型，並可用在 IAM 許可政策陳述式的 Resource 元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型表。

資源類型	ARN	條件索引鍵
topic	arn:${Partition}:sns:${Region}:${Account}:${TopicName}	aws:ResourceTag/${TagKey}

Amazon SNS 的條件索引鍵

Amazon SNS 定義下列條件金鑰，可用於 IAM 政策的 Condition 元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。

若要檢視所有服務都可使用的全域條件索引鍵，請參閱可用的全域條件索引鍵。

條件索引鍵	描述	類型
aws:RequestTag/${TagKey}	按照請求的標籤來篩選存取權	字串
aws:ResourceTag/${TagKey}	依與資源關聯的標籤來篩選存取權	字串
aws:TagKeys	按照請求的標籤金鑰來篩選存取權	ArrayOfString
sns:Endpoint	按照「訂閱」請求或先前確認訂閱中的 URL、電子郵件地址或 ARN 來篩選存取權	字串
sns:Protocol	按照「訂閱」請求或先前確認訂閱中的通訊協定值來篩選存取權	字串