本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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 | 准許建立新組態集 | 寫入 | |||
| CreateConfigurationSetEventDestination | 准許建立組態集事件目標 | 寫入 | |||
| CreateContact | 准許建立聯絡人 | 寫入 | |||
| CreateContactList | 准許建立聯絡人清單 | 寫入 | |||
| CreateCustomVerificationEmailTemplate | 准許建立新的自訂驗證電子郵件範本 | 寫入 | |||
| CreateDedicatedIpPool | 准許建立專用 IP 地址的新集區 | 寫入 | |||
| CreateDeliverabilityTestReport | 准許建立新的可預測性收件匣放置測試 | 寫入 | |||
| CreateEmailIdentity | 准許啟動驗證電子郵件身分的程序 | 寫入 | |||
| CreateEmailIdentityPolicy | 准許建立指定身分識別之指定傳送授權政策 | 許可管理 | |||
| CreateEmailTemplate | 准許建立電子郵件範本 | 寫入 | |||
| CreateExportJob | 准許建立匯出任務 | 寫入 | |||
| CreateImportJob | 准許建立資料目標匯入任務 | 寫入 | |||
| CreateMultiRegionEndpoint | 准許建立新的多區域端點 | 寫入 |
iam:CreateServiceLinkedRole |
||
| CreateTenant | 准許建立新的租用戶 | 寫入 | |||
| CreateTenantResourceAssociation | 准許將 SES 資源與租戶建立關聯 | 寫入 | |||
| DeleteConfigurationSet | 准許刪除現有的組態集 | 寫入 | |||
| DeleteConfigurationSetEventDestination | 准許刪除事件目標 | 寫入 | |||
| DeleteContact | 准許從聯絡人清單中刪除聯絡人 | 寫入 | |||
| DeleteContactList | 准許刪除聯絡人清單及其所有聯絡人 | 寫入 | |||
| DeleteCustomVerificationEmailTemplate | 准許刪除現有自訂驗證電子郵件範本 | 寫入 | |||
| DeleteDedicatedIpPool | 准許刪除專用 IP 集區 | 寫入 | |||
| DeleteEmailIdentity | 准許刪除電子郵件身分 | 寫入 | |||
| DeleteEmailIdentityPolicy | 准許刪除指定身分 (電子郵件地址或網域) 之指定傳送授權政策 | 許可管理 | |||
| DeleteEmailTemplate | 准許刪除電子郵件範本 | 寫入 | |||
| DeleteMultiRegionEndpoint | 准許刪除多區域端點 | 寫入 | |||
| DeleteSuppressedDestination | 准許從帳戶隱藏清單中移除電子郵件地址 | 寫入 | |||
| DeleteTenant | 准許刪除租用戶 | 寫入 | |||
| DeleteTenantResourceAssociation | 准許從租用戶移除相關聯的 SES 資源 | 寫入 | |||
| GetAccount | 准許取得帳戶電子郵件傳送狀態和功能的相關資訊 | 讀取 | |||
| GetBlacklistReports | 准許擷取您專用 IP 地址或追蹤網域出現之拒絕清單的清單 | 讀取 | |||
| GetConfigurationSet | 准許取得現有組態集的相關資訊 | 讀取 | |||
| GetConfigurationSetEventDestinations | 准許擷取組態集相關聯的事件目標清單 | 讀取 | |||
| GetContact | 准許從聯絡人清單傳回聯絡人 | 讀取 | |||
| GetContactList | 准許傳回聯絡人清單中繼資料 | 讀取 | |||
| GetCustomVerificationEmailTemplate | 准許傳回您指定範本名稱的自訂電子郵件驗證範本 | 讀取 | |||
| GetDedicatedIp | 准許取得專用 IP 地址的相關資訊 | 閱讀 | |||
| GetDedicatedIpPool | 准許取得專用 IP 集區的相關資訊 | 閱讀 | |||
| GetDedicatedIps | 准許列出專用 IP 集區的專用 IP 地址 | 讀取 | |||
| GetDeliverabilityDashboardOptions | 准許取得可交付性儀表板的狀態 | 讀取 | |||
| GetDeliverabilityTestReport | 准許擷取可預測性收件匣放置測試的結果 | 讀取 | |||
| GetDomainDeliverabilityCampaign | 准許擷取特定行銷活動的所有可交付性資料 | 讀取 | |||
| GetDomainStatisticsReport | 准許擷取傳送電子郵件時所用網域的收件匣放置和參與率 | 讀取 | |||
| GetEmailIdentity | 准許取得特定身分識別的相關資訊 | 讀取 | |||
| GetEmailIdentityPolicies | 准許針對指定的身分 (電子郵件地址或網域),傳回所請求的傳送授權政策 | 讀取 | |||
| GetEmailTemplate | 准許傳回指定範本的範本物件 (包含主旨行、HTML 部分和文字部分) | 閱讀 | |||
| GetExportJob | 准許獲取有關匯出任務的資訊 | 閱讀 | |||
| GetImportJob | 准許提供匯入任務的相關資訊 | 閱讀 | |||
| GetMessageInsights | 准許提供有關訊息的見解 | 閱讀 | |||
| GetMultiRegionEndpoint | 准許取得多區域端點的相關資訊 | 閱讀 | |||
| GetReputationEntity | 准許擷取評價實體狀態的相關資訊 | 閱讀 | |||
| GetSuppressedDestination | 准許擷取帳戶隱藏清單中特定電子郵件地址的相關資訊 | 閱讀 | |||
| GetTenant | 准許取得租用戶的相關資訊 | 閱讀 | |||
| ListConfigurationSets | 准許列出帳戶的所有組態集 | 列出 | |||
| ListContactLists | 准許列出帳戶可用的所有聯絡人清單 | 列出 | |||
| ListContacts | 准列出特定聯絡人清單中的聯絡人 | 列出 | |||
| ListCustomVerificationEmailTemplates | 准許列出帳戶所有的現有自訂驗證電子郵件範本 | 列出 | |||
| ListDedicatedIpPools | 准許列出帳戶所有的專用 IP 集區 | 列出 | |||
| ListDeliverabilityTestReports | 准許擷取帳戶中您已執行的可預測性收件匣放置測試的清單,而無論其狀態 | 列出 | |||
| ListDomainDeliverabilityCampaigns | 准許為在指定時間範圍內使用特定網域傳送電子郵件的行銷活動列出可交付性資料 | 讀取 | |||
| ListEmailIdentities | 准許列出帳戶電子郵件身分識別 | 列出 | |||
| ListEmailTemplates | 准許列出帳戶所有的電子郵件範本 | 清單 | |||
| ListExportJobs | 准許列出帳戶的所有匯出任務 | 清單 | |||
| ListImportJobs | 准許列出帳戶所有的匯入任務 | 清單 | |||
| ListMultiRegionEndpoints | 准許列出您帳戶的所有多區域端點 | 清單 | |||
| ListRecommendations | 准許針對您的帳戶列出建議 | 閱讀 | |||
| ListReputationEntities | 准許擷取評價實體清單 | 清單 | |||
| ListResourceTenants | 准許列出與 SES 資源相關聯的所有租用戶 | 清單 | |||
| ListSuppressedDestinations | 准許列出帳戶隱藏清單上的電子郵件地址 | 讀取 | |||
| ListTagsForResource | 准許擷取帳戶中與特定資源相關聯的標籤 (索引鍵和值) 清單。 | 閱讀 | |||
| ListTenantResources | 准許列出與租用戶相關聯的所有資源 | 清單 | |||
| ListTenants | 准許列出您帳戶的所有租戶 | 清單 | |||
| PutAccountDedicatedIpWarmupAttributes | 准許啟用或停用專用 IP 地址的自動熱身功能 | 寫入 | |||
| PutAccountDetails | 准許更新帳戶詳細資訊 | 寫入 | |||
| PutAccountSendingAttributes | 准許啟用或停用為帳戶傳送電子郵件的功能 | 寫入 | |||
| PutAccountSuppressionAttributes | 准許變更帳戶層級隱藏清單的設定 | 寫入 | |||
| PutAccountVdmAttributes | 准許針對您的帳戶變更 VDM 設定 | 寫入 | |||
| PutConfigurationSetArchivingOptions | 准許將組態設定與 Mail Manager 封存建立關聯 | 寫入 | |||
| PutConfigurationSetDeliveryOptions | 准許建立組態集與專用 IP 集區的關聯 | 寫入 | |||
| PutConfigurationSetReputationOptions | 針對使用特定組態集傳送的電子郵件,准許啟用或停用收集評價指標 | 寫入 | |||
| PutConfigurationSetSendingOptions | 准許啟用或停用針對使用特定組態集之訊息的電子郵件傳送 | 寫入 | |||
| PutConfigurationSetSuppressionOptions | 准許指定特定組態集之帳戶隱藏清單的偏好設定 | 寫入 | |||
| PutConfigurationSetTrackingOptions | 准許指定自訂網域,用於打開和按一下為特定組態集傳送之電子郵件中的追蹤項目 | 寫入 | |||
| PutConfigurationSetVdmOptions | 准許針對特定組態集覆寫帳戶層級的 VDM 設定 | 寫入 | |||
| PutDedicatedIpInPool | 准許將專用 IP 地址移至現有專用 IP 集區 | 寫入 | |||
| PutDedicatedIpPoolScalingAttributes | 准許將專用 IP 集區從標準轉換為受管 | 寫入 | |||
| PutDedicatedIpWarmupAttributes | 准許放置專用 IP 熱身屬性 | 寫入 | |||
| PutDeliverabilityDashboardOption | 准許啟用或停用可交付性儀表板 | 寫入 | |||
| PutEmailIdentityConfigurationSetAttributes | 准許將組態集與電子郵件身分識別相關聯 | 寫入 | |||
| PutEmailIdentityDkimAttributes | 准許啟用或停用電子郵件身分識別的 DKIM 身分驗證 | 寫入 | |||
| PutEmailIdentityDkimSigningAttributes | 准許設定或變更電子郵件網域身分識別之 DKIM 身分驗證設定 | 寫入 | |||
| PutEmailIdentityFeedbackAttributes | 准許啟用或停用電子郵件身分識別的意見回饋轉寄 | 寫入 | |||
| PutEmailIdentityMailFromAttributes | 准許啟用或停用電子郵件身分識別的自訂 MAIL FROM 網域組態 | 寫入 | |||
| PutSuppressedDestination | 准許將電子郵件地址新增至隱藏清單 | 寫入 | |||
| ReplicateEmailIdentityDkimSigningKey [僅限許可] | 准許複寫電子郵件身分 DKIM 簽署金鑰 | 許可管理 | |||
| SendBulkEmail | 准許撰寫電子郵件訊息給多個目標 | 寫入 | |||
| SendCustomVerificationEmail | 准許將電子郵件地址新增至身分識別清單並嘗試驗證 | 寫入 | |||
| SendEmail | 准許傳送電子郵件訊息 | 寫入 | |||
| TagResource | 准許將一或多個標籤 (索引鍵和值) 新增到指定的資源 | 標記 | |||
| TestRenderEmailTemplate | 隨附範本和一組替換資料時,准許建立電子郵件的 MIME 內容預覽 | 寫入 | |||
| UntagResource | 准許以從指定的資源移除一或多個標籤 (索引鍵和值) | 標記 | |||
| UpdateConfigurationSetEventDestination | 准許為組態集更新事件目標的組態 | 寫入 | |||
| UpdateContact | 准許更新聯絡人清單偏好設定 | 寫入 | |||
| UpdateContactList | 准許更新聯絡人清單中繼資料 | 寫入 | |||
| UpdateCustomVerificationEmailTemplate | 准許更新現有的自訂驗證電子郵件範本 | 寫入 | |||
| UpdateEmailIdentityPolicy | 准許更新指定身分 (電子郵件地址或網域) 之指定傳送授權政策 | 許可管理 | |||
| UpdateEmailTemplate | 准許更新電子郵件範本 | 寫入 | |||
| UpdateReputationEntityCustomerManagedStatus | 准許更新客戶受管傳送狀態 | 寫入 | |||
| UpdateReputationEntityPolicy | 准許指派評價政策 | 寫入 | |||
Amazon Simple Email Service v2 定義的資源類型
此服務會定義下列資源類型,並可用在 IAM 許可政策陳述式的 Resource 元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊,請參閱資源類型資料表。
| 資源類型 | ARN | 條件索引鍵 |
|---|---|---|
| reputation-policy |
arn:${Partition}:ses:${Region}:aws:reputation-policy/${ReputationPolicyName}
|
|
| 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}
|
|
| multi-region-endpoint |
arn:${Partition}:ses:${Region}:${Account}:multi-region-endpoint/${EndpointName}
|
|
| mailmanager-archive |
arn:${Partition}:ses:${Region}:${Account}:mailmanager-archive/${ArchiveId}
|
|
| tenant |
arn:${Partition}:ses:${Region}:${Account}:tenant/${TenantName}/${TenantId}
|
Amazon Simple Email Service v2 的條件索引鍵
Amazon Simple Email Service v2 定義了下列條件索引鍵,可用於 IAM 政策的 Condition 元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊,請參閱條件索引鍵表。
若要檢視所有 服務可用的全域條件索引鍵,請參閱AWS 全域條件內容索引鍵。
| 條件索引鍵 | 描述 | 類型 |
|---|---|---|
| aws:RequestTag/${TagKey} | 依請求中的標籤鍵值對是否存在篩選存取權 | 字串 |
| aws:ResourceTag/${TagKey} | 依連接到資源的標籤鍵值對篩選存取權 | 字串 |
| aws:TagKeys | 依請求中是否存在標籤索引鍵來篩選存取 | ArrayOfString |
| ses:ApiVersion | 根據 SES API 版本篩選存取權 | String |
| ses:ExportSourceType | 根據匯出來源類型篩選存取權 | String |
| ses:FeedbackAddress | 根據「傳回路徑」地址篩選存取權,它指定了電子郵件意見回饋轉寄將退信和抱怨送往何處 | String |
| ses:FromAddress | 根據訊息的「寄件者」地址篩選存取權 | String |
| ses:FromDisplayName | 根據用作訊息顯示名稱的「寄件者」地址篩選存取權 | String |
| ses:MultiRegionEndpointId | 依用於傳送電子郵件的多區域端點 ID 篩選存取權 | String |
| ses:Recipients | 根據訊息的收件人地址篩選存取權,其中包括「收件人」、「副本」和「密件副本」地址 | ArrayOfString |
| ses:ReplicaRegion | 依複寫網域 DKIM 簽署金鑰的複本區域篩選存取權 | ArrayOfString |
| ses:TenantName | 依用於傳送電子郵件的租戶名稱篩選存取權 | String |