本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon 的動作、資源和條件索引鍵 SNS
Amazon SNS(服務字首:sns
) 提供下列服務特定的資源、動作和條件內容索引鍵,可用於IAM許可政策。
參考資料:
-
了解如何設定此服務。
-
檢視API此服務可用的操作清單 。
-
了解如何使用IAM許可政策來保護此服務及其資源。
Amazon 定義的動作 SNS
您可以在IAM政策陳述式的 Action
元素中指定下列動作。使用政策來授予在 AWS中執行操作的許可。當您在政策中使用動作時,通常會允許或拒絕對相同名稱API的操作或CLI命令的存取。不過,在某些情況下,單一動作可控制對多個操作的存取。或者,某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值,您必須在政策陳述式的 Resource
元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型,則您可以在具有該動作ARN的陳述式中指定該類型的 。如果動作具有一或多個必要資源,呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您在IAM政策中使用 Resource
元素限制資源存取,則必須為每個所需資源類型包含 ARN或 模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要),則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition
元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊,請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄,其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊,請參閱動作資料表。
動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
---|---|---|---|---|---|
AddPermission | 准許將陳述式新增至主題的存取控制政策,將指定 AWS 帳戶的存取權授予指定的動作 | 許可管理 | |||
CheckIfPhoneNumberIsOptedOut | 准許接受電話號碼,並指出電話持有人是否已選擇不接收來自您帳戶SMS的訊息 | 讀取 | |||
ConfirmSubscription | 准許驗證先前的「訂閱」動作傳送到端點的符記有效,以確認端點擁有者想要接收訊息 | 寫入 | |||
CreatePlatformApplication | 准許為其中一個支援的推送通知服務建立平台應用程式物件,例如 APNS和 GCM,裝置和行動應用程式可以註冊這些服務 | 寫入 |
iam:PassRole |
||
CreatePlatformEndpoint | 准許在其中一個支援的推送通知服務上為裝置和行動應用程式建立端點,例如 GCM和 APNS | 寫入 | |||
CreateSMSSandboxPhoneNumber | 准許新增目的地電話號碼,並將一次性密碼 (OTP) 傳送至 的該電話號碼 AWS 帳戶 | 寫入 | |||
CreateTopic | 准許建立可發佈通知的主題 | 寫入 |
iam:PassRole |
||
DeleteEndpoint | 准許從 Amazon 刪除裝置和行動應用程式的端點 SNS | 寫入 | |||
DeletePlatformApplication | 准許刪除其中一個支援的推送通知服務的平台應用程式物件,例如 APNS和 GCM | 寫入 | |||
DeleteSMSSandboxPhoneNumber | 准許刪除 AWS 帳戶已驗證或待定的電話號碼 | 寫入 | |||
DeleteTopic | 准許刪除主題及其所有訂閱 | 寫入 | |||
GetDataProtectionPolicy | 准許傳回主題的資料保護政策 | 讀取 | |||
GetEndpointAttributes | 准許在其中一個支援的推送通知服務上擷取裝置的端點屬性,例如 GCM和 APNS | 讀取 | |||
GetPlatformApplicationAttributes | 准許擷取支援推送通知服務的平台應用程式物件屬性,例如 APNS和 GCM | 讀取 | |||
GetSMSAttributes | 准許傳回SMS從您的帳戶傳送訊息的設定 | 讀取 | |||
GetSMSSandboxAccountStatus | 准許擷取目標區域中呼叫帳戶的沙盒狀態 | 讀取 | |||
GetSubscriptionAttributes | 准許傳回訂閱的所有屬性 | 讀取 | |||
GetTopicAttributes | 准許傳回主題的所有屬性 | 讀取 | |||
ListEndpointsByPlatformApplication | 准許列出支援推送通知服務中裝置的端點和端點屬性,例如 GCM和 APNS | 清單 | |||
ListOriginationNumbers | 准許列出所有原始編號及其中繼資料 | 清單 | |||
ListPhoneNumbersOptedOut | 准許傳回選擇退出的電話號碼清單,這表示您無法SMS傳送訊息給他們 | 讀取 | |||
ListPlatformApplications | 准許列出支援推送通知服務的平台應用程式物件,例如 APNS和 GCM | 清單 | |||
ListSMSSandboxPhoneNumbers | 准許列出呼叫帳戶目前的待處理和已驗證目的地電話號碼 | 列出 | |||
ListSubscriptions | 准許傳回請求者的訂閱清單 | 列出 | |||
ListSubscriptionsByTopic | 准許傳回訂閱清單至特定主題 | 清單 | |||
ListTagsForResource | 准許列出新增至指定 Amazon SNS主題的所有標籤 | 讀取 | |||
ListTopics | 准許傳回請求者主題的清單 | 清單 | |||
OptInPhoneNumber | 准許選擇目前選擇退出的電話號碼,這可讓您繼續SMS傳送訊息至該號碼 | 寫入 | |||
Publish | 准許傳送訊息給主題的所有訂閱端點 | 寫入 | |||
PutDataProtectionPolicy | 准許允許主題擁有者設定資料保護政策 | 寫入 | |||
RemovePermission | 准許從主題存取控制政策中移除陳述式 | 許可管理 | |||
SetEndpointAttributes | 准許在其中一個支援的推送通知服務上設定裝置的端點屬性,例如 GCM和 APNS | 寫入 | |||
SetPlatformApplicationAttributes | 准許為支援的推送通知服務設定平台應用程式物件的屬性,例如 APNS和 GCM | 寫入 |
iam:PassRole |
||
SetSMSAttributes | 准許設定SMS傳送訊息和接收每日SMS用量報告的預設設定 | 寫入 | |||
SetSubscriptionAttributes | 准許允許訂閱擁有者將主題屬性設定為新值 | 寫入 | |||
SetTopicAttributes | 准許允許主題擁有者將主題屬性設定為新值 | 許可管理 |
iam:PassRole |
||
Subscribe | 透過傳送端點確認訊息,准許準備訂閱端點 | 寫入 | |||
TagResource | 准許將標籤新增至指定的 Amazon SNS主題 | 標記 | |||
Unsubscribe | 准許刪除訂閱 | 寫入 | |||
UntagResource | 准許從指定的 Amazon SNS主題移除標籤 | 標記 | |||
VerifySMSSandboxPhoneNumber | 准許驗證具有一次性密碼 (OTP) 的目的地電話號碼 AWS 帳戶 | 寫入 |
Amazon 定義的資源類型 SNS
下列資源類型由此服務定義,可用於IAM許可政策陳述式的 Resource
元素。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊,請參閱資源類型資料表。
資源類型 | ARN | 條件索引鍵 |
---|---|---|
topic |
arn:${Partition}:sns:${Region}:${Account}:${TopicName}
|
Amazon 的條件索引鍵 SNS
Amazon 會SNS定義下列條件索引鍵,可用於IAM政策的 Condition
元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊,請參閱條件索引鍵表。
若要檢視所有服務都可使用的全域條件鍵,請參閱可用全域條件鍵。
條件索引鍵 | 描述 | Type |
---|---|---|
aws:RequestTag/${TagKey} | 按照請求的標籤來篩選存取權 | 字串 |
aws:ResourceTag/${TagKey} | 依與資源關聯的標籤來篩選存取權 | 字串 |
aws:TagKeys | 按照請求的標籤金鑰來篩選存取權 | ArrayOfString |
sns:Endpoint | 依 URL、電子郵件地址,或從ARN訂閱請求或先前確認的訂閱篩選存取權 | 字串 |
sns:Protocol | 按照「訂閱」請求或先前確認訂閱中的通訊協定值來篩選存取權 | 字串 |