本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon Pinpoint 的動作、資源和條件索引鍵
Amazon Pinpoint (服務字首:mobiletargeting) 提供下列服務特有的資源、動作和條件內容索引鍵,可用於 IAM 許可政策。
參考資料:
-
了解如何設定此服務。
-
檢視可供此服務使用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
Amazon Pinpoint 定義的動作
您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時,通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過,在某些情況下,單一動作可控制對多個操作的存取。或者,某些操作需要多種不同的動作。
動作資料表的存取層級欄說明動作的分類方式 (列出、讀取、許可管理或標記)。此分類可協助您了解在政策中使用某動作時,該動作授予您的存取層級。如需存取層級的詳細資訊,請參閱政策摘要中的存取層級。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值,您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型,則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源,呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取,則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要),則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊,請參閱「資源類型」資料表的條件索引鍵欄。
動作資料表的相依動作欄會顯示成功呼叫動作所需的其他許可。除了動作本身的許可之外,還可能需要這些許可。當動作指定相依動作時,這些相依性可能適用於針對該動作定義的其他資源,而不只是資料表中列出的第一個資源。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄,其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊,請參閱動作資料表。
| 動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
|---|---|---|---|---|---|
| CreateApp | 准許建立應用程式 | 寫入 | |||
| CreateCampaign | 准許建立行銷活動或應用程式 | 寫入 | |||
| CreateEmailTemplate | 准許建立電子郵件範本 | 寫入 | |||
| CreateExportJob | 准許建立匯出任務,將端點定義匯出到 Amazon S3 | 寫入 | |||
| CreateImportJob | 准許匯入端點定義來建立客群 | 寫入 | |||
| CreateInAppTemplate | 准許建立應用程式內訊息範本 | 寫入 | |||
| CreateJourney | 准許為應用程式建立行程 | 寫入 | |||
| CreatePushTemplate | 准許建立推送通知範本 | 寫入 | |||
| CreateRecommenderConfiguration | 准許為建議者模型建立 Amazon Pinpoint 組態 | 寫入 | |||
| CreateSegment | 准許根據您的應用程式向 Pinpoint 報告的端點資料建立客群。若要讓使用者從 Pinpoint 外匯入端點資料來建立客群,請允許 mobiletargeting:CreateImportJob 動作 | 寫入 | |||
| CreateSmsTemplate | 准許建立簡訊範本 | 寫入 | |||
| CreateVoiceTemplate | 准許建立語音訊息範本 | 寫入 | |||
| DeleteAdmChannel | 准許刪除應用程式的 ADM 頻道 | 寫入 | |||
| DeleteApnsChannel | 准許刪除應用程式的 APNs 頻道 | 寫入 | |||
| DeleteApnsSandboxChannel | 准許刪除應用程式的 APNs 沙盒頻道 | 寫入 | |||
| DeleteApnsVoipChannel | 准許刪除應用程式的 APNs VoIP 頻道 | 寫入 | |||
| DeleteApnsVoipSandboxChannel | 准許刪除應用程式的 APNs VoIP 沙盒頻道 | 寫入 | |||
| DeleteApp | 准許刪除特定行銷活動 | 寫入 | |||
| DeleteBaiduChannel | 准許刪除應用程式的 Baidu 頻道 | 寫入 | |||
| DeleteCampaign | 准許刪除特定行銷活動 | 寫入 | |||
| DeleteEmailChannel | 准許刪除應用程式的電子郵件頻道 | 寫入 | |||
| DeleteEmailTemplate | 准許刪除電子郵件範本或電子郵件範本版本 | 寫入 | |||
| DeleteEndpoint | 准許刪除端點 | 寫入 | |||
| DeleteEventStream | 准許刪除應用程式的事件資料流 | 寫入 | |||
| DeleteGcmChannel | 准許刪除應用程式的 GCM 頻道 | 寫入 | |||
| DeleteInAppTemplate | 准許刪除應用程式內訊息範本或應用程式內訊息範本版本 | 寫入 | |||
| DeleteJourney | 准許刪除特定行程 | 寫入 | |||
| DeletePushTemplate | 准許刪除推送通知範本或推送通知範本版本 | 寫入 | |||
| DeleteRecommenderConfiguration | 准許刪除建議者模型的 Amazon Pinpoint 組態 | 寫入 | |||
| DeleteSegment | 准許刪除特定客群 | 寫入 | |||
| DeleteSmsChannel | 准許刪除應用程式的簡訊頻道 | 寫入 | |||
| DeleteSmsTemplate | 准許刪除簡訊範本或簡訊範本版本 | 寫入 | |||
| DeleteUserEndpoints | 准許刪除與使用者 ID 相關聯的所有端點 | 寫入 | |||
| DeleteVoiceChannel | 准許刪除應用程式的語音頻道 | 寫入 | |||
| DeleteVoiceTemplate | 准許刪除語音訊息範本或語音訊息範本版本 | 寫入 | |||
| GetAdmChannel | 准許擷取應用程式的 Amazon Device Messaging (ADM) 頻道的相關資訊 | 閱讀 | |||
| GetApnsChannel | 准許擷取應用程式的 APNs 頻道的相關資訊 | 閱讀 | |||
| GetApnsSandboxChannel | 准許擷取應用程式的 APNs 沙盒頻道的相關資訊 | 閱讀 | |||
| GetApnsVoipChannel | 准許擷取應用程式的 APNs VoIP 頻道的相關資訊 | 閱讀 | |||
| GetApnsVoipSandboxChannel | 准許擷取應用程式的 APNs VoIP 沙盒頻道的相關資訊 | 閱讀 | |||
| GetApp | 准許擷取 Amazon Pinpoint 帳戶中特定應用程式的相關資訊 | 閱讀 | |||
| GetApplicationDateRangeKpi | 准許擷取 (查詢) 適用於應用程式之標準指標的預先彙總資料 | 閱讀 | |||
| GetApplicationSettings | 准許擷取物件的預設設定 | 列出 | |||
| GetApps | 准許擷取 Amazon Pinpoint 帳戶中的應用程式清單 | 閱讀 | |||
| GetBaiduChannel | 准許擷取應用程式的 Baidu 頻道的相關資訊 | 閱讀 | |||
| GetCampaign | 准許擷取特定行銷活動的相關資訊 | 閱讀 | |||
| GetCampaignActivities | 准許擷取行銷活動所執行的活動的相關資訊 | 列出 | |||
| GetCampaignDateRangeKpi | 准許擷取 (查詢) 適用於行銷活動之標準指標的預先彙總資料 | 閱讀 | |||
| GetCampaignVersion | 准許擷取特定行銷活動版本的相關資訊 | 閱讀 | |||
| GetCampaignVersions | 准許擷取行銷活動的目前和之前版本的相關資訊 | 列出 | |||
| GetCampaigns | 准許擷取應用程式的所有行銷活動的相關資訊 | 列出 | |||
| GetChannels | 准許取得應用程式的所有頻道資訊 | 列出 | |||
| GetEmailChannel | 准許取得應用程式中電子郵件頻道的相關資訊 | 閱讀 | |||
| GetEmailTemplate | 准許擷取電子郵件範本特定版本或使用中版本的相關資訊 | 閱讀 | |||
| GetEndpoint | 准許擷取特定端點的相關資訊 | 閱讀 | |||
| GetEventStream | 准許擷取應用程式的事件資料流的相關資訊 | 閱讀 | |||
| GetExportJob | 准許取得特定匯出任務的相關資訊 | 閱讀 | |||
| GetExportJobs | 准許擷取應用程式的所有匯出任務的清單 | 列出 | |||
| GetGcmChannel | 准許擷取應用程式的 GCM 頻道的相關資訊 | 閱讀 | |||
| GetImportJob | 准許擷取特定匯入任務的相關資訊 | 閱讀 | |||
| GetImportJobs | 准許擷取應用程式的所有匯入任務的相關資訊 | 列出 | |||
| GetInAppMessages | 准許擷取指定端點 ID 的應用程式內訊息 | 閱讀 | |||
| GetInAppTemplate | 准許擷取應用程式內訊息範本特定版本或使用中版本的相關資訊 | 閱讀 | |||
| GetJourney | 准許擷取特定行程的相關資訊 | 閱讀 | |||
| GetJourneyDateRangeKpi | 准許擷取 (查詢) 適用於行程之標準參與指標的預先彙總資料 | 閱讀 | |||
| GetJourneyExecutionActivityMetrics | 准許擷取 (查詢) 適用於行程活動之標準執行指標的預先彙總資料 | 閱讀 | |||
| GetJourneyExecutionMetrics | 准許擷取 (查詢) 適用於行程之標準執行指標的預先彙總資料 | 閱讀 | |||
| GetJourneyRunExecutionActivityMetrics | 准許擷取 (查詢) 單個旅程執行的旅程活動所套用的標準執行指標的預先彙總資料 | 閱讀 | |||
| GetJourneyRunExecutionMetrics | 准許擷取 (查詢) 單個旅程執行的旅程所套用的標準執行指標的預先彙總資料 | 閱讀 | |||
| GetJourneyRuns | 准許擷取旅程的所有旅程執行的相關資訊 | 清單 | |||
| GetPushTemplate | 准許擷取推送通知範本特定版本或使用中版本的相關資訊 | 閱讀 | |||
| GetRecommenderConfiguration | 准許擷取建議者模型的 Amazon Pinpoint 組態的相關資訊 | 閱讀 | |||
| GetRecommenderConfigurations | 准許擷取與 Amazon Pinpoint 帳戶相關聯之所有建議者模型組態的相關資訊 | 清單 | |||
| GetReports [僅限許可] | 准許 mobiletargeting:GetReports | 閱讀 | |||
| GetSegment | 准許擷取特定客群的相關資訊 | 閱讀 | |||
| GetSegmentExportJobs | 准許針對將端點定義從客群匯出到 Amazon S3 的任務擷取相關資訊 | 列出 | |||
| GetSegmentImportJobs | 准許針對匯入端點定義來建立客群的任務擷取相關資訊 | 列出 | |||
| GetSegmentVersion | 准許擷取特定客群版本的相關資訊 | 閱讀 | |||
| GetSegmentVersions | 准許擷取客群的目前和之前版本的相關資訊 | 列出 | |||
| GetSegments | 准許擷取應用程式的客群的相關資訊 | 列出 | |||
| GetSmsChannel | 准許取得應用程式中簡訊頻道的相關資訊 | 閱讀 | |||
| GetSmsTemplate | 准許擷取簡訊範本特定版本或使用中版本的相關資訊 | 閱讀 | |||
| GetUserEndpoints | 准許擷取與使用者 ID 相關聯的端點的相關資訊 | 閱讀 | |||
| GetVoiceChannel | 准許取得應用程式中語音頻道的相關資訊 | 閱讀 | |||
| GetVoiceTemplate | 准許擷取語音訊息範本特定版本或使用中版本的相關資訊 | 閱讀 | |||
| ListJourneys | 准許擷取應用程式所有行程的相關資訊 | 列出 | |||
| ListTagsForResource | 准許列出資源的標籤 | 閱讀 | |||
| ListTemplateVersions | 准許擷取特定範本的所有版本 | 列出 | |||
| ListTemplates | 准許擷取有關所查詢範本的中繼資料 | 列出 | |||
| PhoneNumberValidate | 准許取得電話號碼的中繼資料,例如號碼類型 (行動電話、有線電話或 VoIP)、位置和供應商 | 閱讀 | |||
| PutEventStream | 准許建立或更新應用程式的事件資料流 | 寫入 | |||
| PutEvents | 准許建立或更新應用程式的事件 | 寫入 | |||
| RemoveAttributes | 准許移除應用程式的屬性 | 寫入 | |||
| SendMessages | 准許將簡訊或推送通知傳送到特定端點 | 寫入 | |||
| SendOTPMessage | 准許傳送 OTP 代碼至應用程式的使用者 | 寫入 | |||
| SendUsersMessages | 准許將簡訊或推送通知傳送到與特定使用者 ID 相關聯的所有端點 | 寫入 | |||
| TagResource | 准許將 標籤新增至資源 | 標記 | |||
| UntagResource | 授予許可來從資源中移除標籤 | 標記 | |||
| UpdateAdmChannel | 准許更新應用程式的 Amazon Device Messaging (ADM) 頻道 | 寫入 | |||
| UpdateApnsChannel | 准許更新應用程式的 Apple 推送通知服務 (APNs) 頻道 | 寫入 | |||
| UpdateApnsSandboxChannel | 准許更新應用程式的 Apple 推送通知服務 (APNs) 沙盒頻道 | 寫入 | |||
| UpdateApnsVoipChannel | 准許更新應用程式的 Apple 推送通知服務 (APNs) VoIP 頻道 | 寫入 | |||
| UpdateApnsVoipSandboxChannel | 准許更新應用程式的 Apple 推送通知服務 (APNs) VoIP 沙盒頻道 | 寫入 | |||
| UpdateApplicationSettings | 准許更新應用程式的預設設定 | 寫入 | |||
| UpdateBaiduChannel | 准許更新應用程式的 Baidu 頻道 | 寫入 | |||
| UpdateCampaign | 准許更新特定行銷活動 | 寫入 | |||
| UpdateEmailChannel | 准許更新應用程式的電子郵件頻道 | 寫入 | |||
| UpdateEmailTemplate | 准許更新相同版本下的特定電子郵件範本或產生新版本 | 寫入 | |||
| UpdateEndpoint | 准許建立端點或更新端點的資訊 | 寫入 | |||
| UpdateEndpointsBatch | 准許以批次操作來建立或更新端點 | 寫入 | |||
| UpdateGcmChannel | 准許更新 Firebase Cloud Messaging (FCM) 或 Google Cloud Messaging (GCM) API 金鑰,此金鑰允許將推送通知傳送到 Android 應用程式 | 寫入 | |||
| UpdateInAppTemplate | 准許更新相同版本下的特定應用程式內訊息範本或產生新版本 | 寫入 | |||
| UpdateJourney | 准許更新特定行程 | 寫入 | |||
| UpdateJourneyState | 准許更新特定行程狀態 | 寫入 | |||
| UpdatePushTemplate | 准許更新相同版本下的特定推送通知範本或產生新版本 | 寫入 | |||
| UpdateRecommenderConfiguration | 准許更新建議者模型的 Amazon Pinpoint 組態 | 寫入 | |||
| UpdateSegment | 准許更新特定客群 | 寫入 | |||
| UpdateSmsChannel | 准許更新應用程式的簡訊頻道 | 寫入 | |||
| UpdateSmsTemplate | 准許更新相同版本下的特定簡訊範本或產生新版本 | 寫入 | |||
| UpdateTemplateActiveVersion | 准許更新特定範本的使用中版本參數 | 寫入 | |||
| UpdateVoiceChannel | 准許更新應用程式的語音頻道 | 寫入 | |||
| UpdateVoiceTemplate | 准許更新相同版本下的特定語音訊息範本或產生新版本 | 寫入 | |||
| VerifyOTPMessage | 准許檢查一次性密碼 (OTP) 的有效性 | 寫入 |
Amazon Pinpoint 定義的資源類型
此服務會定義下列資源類型,並可用在 IAM 許可政策陳述式的 Resource 元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊,請參閱資源類型資料表。
| 資源類型 | ARN | 條件索引鍵 |
|---|---|---|
| app |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}
|
|
| apps |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/*
|
|
| campaign |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/campaigns/${CampaignId}
|
|
| journey |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/journeys/${JourneyId}
|
|
| journeys |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/journeys
|
|
| segment |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/segments/${SegmentId}
|
|
| template |
arn:${Partition}:mobiletargeting:${Region}:${Account}:templates/${TemplateName}/${TemplateType}
|
|
| templates |
arn:${Partition}:mobiletargeting:${Region}:${Account}:templates
|
|
| recommender |
arn:${Partition}:mobiletargeting:${Region}:${Account}:recommenders/${RecommenderId}
|
|
| recommenders |
arn:${Partition}:mobiletargeting:${Region}:${Account}:recommenders/*
|
|
| phone-number-validate |
arn:${Partition}:mobiletargeting:${Region}:${Account}:phone/number/validate
|
|
| channels |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/channels
|
|
| channel |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/channels/${ChannelType}
|
|
| event-stream |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/eventstream
|
|
| events |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/events
|
|
| messages |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/messages
|
|
| verify-otp |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/verify-otp
|
|
| otp |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/otp
|
|
| attribute |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/attributes/${AttributeType}
|
|
| user |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/users/${UserId}
|
|
| endpoint |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/endpoints/${EndpointId}
|
|
| import-job |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/jobs/import/${JobId}
|
|
| export-job |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/jobs/export/${JobId}
|
|
| application-metrics |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/kpis/daterange/${KpiName}
|
|
| campaign-metrics |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/campaigns/${CampaignId}/kpis/daterange/${KpiName}
|
|
| journey-metrics |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/journeys/${JourneyId}/kpis/daterange/${KpiName}
|
|
| journey-execution-metrics |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/journeys/${JourneyId}/execution-metrics
|
|
| journey-execution-activity-metrics |
arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/journeys/${JourneyId}/activities/${JourneyActivityId}/execution-metrics
|
|
| reports |
arn:${Partition}:mobiletargeting:${Region}:${Account}:reports
|
Amazon Pinpoint 的條件索引鍵
Amazon Pinpoint 定義了下列條件索引鍵,可用於 IAM 政策的 Condition 元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊,請參閱條件索引鍵表。
若要檢視所有 服務可用的全域條件索引鍵,請參閱AWS 全域條件內容索引鍵。
| 條件索引鍵 | 描述 | 類型 |
|---|---|---|
| aws:RequestTag/${TagKey} | 依使用者對 Pinpoint 服務所做請求中存在的索引鍵篩選存取權 | 字串 |
| aws:ResourceTag/${TagKey} | 依標籤鍵值組來篩選存取 | 字串 |
| aws:TagKeys | 依使用者對 Pinpoint 服務所做請求中存在的所有標籤索引鍵名稱清單篩選存取權 | ArrayOfString |