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

Amazon Pinpoint (服務字首：mobiletargeting) 提供下列服務特有的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。

參考資料：

• 了解如何設定此服務。

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

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

Amazon Pinpoint 定義的動作

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

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

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

注意

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

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

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
CreateApp	准許建立應用程式	寫入	apps*
				aws:RequestTag/${TagKey} aws:TagKeys aws:ResourceTag/${TagKey}
CreateCampaign	准許建立行銷活動或應用程式	寫入	app*
				aws:RequestTag/${TagKey} aws:TagKeys aws:ResourceTag/${TagKey}
CreateEmailTemplate	准許建立電子郵件範本	寫入	template*
				aws:RequestTag/${TagKey} aws:TagKeys aws:ResourceTag/${TagKey}
CreateExportJob	准許建立匯出任務，將端點定義匯出到 Amazon S3	寫入	app*
CreateImportJob	准許匯入端點定義來建立客群	寫入	app*
CreateInAppTemplate	准許建立應用程式內訊息範本	寫入	template*
				aws:RequestTag/${TagKey} aws:TagKeys aws:ResourceTag/${TagKey}
CreateJourney	准許為應用程式建立行程	寫入	journeys*
				aws:RequestTag/${TagKey} aws:TagKeys aws:ResourceTag/${TagKey}
CreatePushTemplate	准許建立推送通知範本	寫入	template*
				aws:RequestTag/${TagKey} aws:TagKeys aws:ResourceTag/${TagKey}
CreateRecommenderConfiguration	准許為建議者模型建立 Amazon Pinpoint 組態	寫入	recommenders*
CreateSegment	准許根據您的應用程式向 Pinpoint 報告的端點資料建立客群。若要允許使用者透過從精準點以外匯入端點資料來建立區段，請允許行動裝置設定:動作 CreateImportJob	寫入	app*
				aws:RequestTag/${TagKey} aws:TagKeys aws:ResourceTag/${TagKey}
CreateSmsTemplate	准許建立簡訊範本	寫入	template*
				aws:RequestTag/${TagKey} aws:TagKeys aws:ResourceTag/${TagKey}
CreateVoiceTemplate	准許建立語音訊息範本	寫入	template*
				aws:RequestTag/${TagKey} aws:TagKeys aws:ResourceTag/${TagKey}
DeleteAdmChannel	准許刪除應用程式的 ADM 頻道	寫入	channel*
DeleteApnsChannel	准許刪除應用程式的 APNs 頻道	寫入	channel*
DeleteApnsSandboxChannel	准許刪除應用程式的 APNs 沙盒頻道	寫入	channel*
DeleteApnsVoipChannel	准許刪除應用程式的 APNs VoIP 頻道	寫入	channel*
DeleteApnsVoipSandboxChannel	准許刪除應用程式的 APNs VoIP 沙盒頻道	寫入	channel*
DeleteApp	准許刪除特定行銷活動	寫入	app*
DeleteBaiduChannel	准許刪除應用程式的 Baidu 頻道	寫入	channel*
DeleteCampaign	准許刪除特定行銷活動	寫入	campaign*
DeleteEmailChannel	准許刪除應用程式的電子郵件頻道	寫入	channel*
DeleteEmailTemplate	准許刪除電子郵件範本或電子郵件範本版本	寫入	template*
DeleteEndpoint	准許刪除端點	寫入	endpoint*
DeleteEventStream	准許刪除應用程式的事件資料流	寫入	event-stream*
DeleteGcmChannel	准許刪除應用程式的 GCM 頻道	寫入	channel*
DeleteInAppTemplate	准許刪除應用程式內訊息範本或應用程式內訊息範本版本	寫入	template*
DeleteJourney	准許刪除特定行程	寫入	journey*
DeletePushTemplate	准許刪除推送通知範本或推送通知範本版本	寫入	template*
DeleteRecommenderConfiguration	准許刪除建議者模型的 Amazon Pinpoint 組態	寫入	recommender*
DeleteSegment	准許刪除特定客群	寫入	segment*
DeleteSmsChannel	准許刪除應用程式的簡訊頻道	寫入	channel*
DeleteSmsTemplate	准許刪除簡訊範本或簡訊範本版本	寫入	template*
DeleteUserEndpoints	准許刪除與使用者 ID 相關聯的所有端點	寫入	user*
DeleteVoiceChannel	准許刪除應用程式的語音頻道	寫入	channel*
DeleteVoiceTemplate	准許刪除語音訊息範本或語音訊息範本版本	寫入	template*
GetAdmChannel	准許擷取應用程式的 Amazon Device Messaging (ADM) 頻道的相關資訊	讀取	channel*
GetApnsChannel	准許擷取應用程式的 APNs 頻道的相關資訊	讀取	channel*
GetApnsSandboxChannel	准許擷取應用程式的 APNs 沙盒頻道的相關資訊	讀取	channel*
GetApnsVoipChannel	准許擷取應用程式的 APNs VoIP 頻道的相關資訊	讀取	channel*
GetApnsVoipSandboxChannel	准許擷取應用程式的 APNs VoIP 沙盒頻道的相關資訊	讀取	channel*
GetApp	准許擷取 Amazon Pinpoint 帳戶中特定應用程式的相關資訊	讀取	app*
GetApplicationDateRangeKpi	准許擷取 (查詢) 適用於應用程式之標準指標的預先彙總資料	讀取	application-metrics*
GetApplicationSettings	准許擷取物件的預設設定	列出	app*
GetApps	准許擷取 Amazon Pinpoint 帳戶中的應用程式清單	讀取	apps*
GetBaiduChannel	准許擷取應用程式的 Baidu 頻道的相關資訊	讀取	channel*
GetCampaign	准許擷取特定行銷活動的相關資訊	讀取	campaign*
GetCampaignActivities	准許擷取行銷活動所執行的活動的相關資訊	列出	campaign*
GetCampaignDateRangeKpi	准許擷取 (查詢) 適用於行銷活動之標準指標的預先彙總資料	讀取	campaign-metrics*
GetCampaignVersion	准許擷取特定行銷活動版本的相關資訊	讀取	campaign*
GetCampaignVersions	准許擷取行銷活動的目前和之前版本的相關資訊	列出	campaign*
GetCampaigns	准許擷取應用程式的所有行銷活動的相關資訊	列出	app*
GetChannels	准許取得應用程式的所有頻道資訊	列出	channels*
GetEmailChannel	准許取得應用程式中電子郵件頻道的相關資訊	讀取	channel*
GetEmailTemplate	准許擷取電子郵件範本特定版本或使用中版本的相關資訊	讀取	template*
GetEndpoint	准許擷取特定端點的相關資訊	讀取	endpoint*
GetEventStream	准許擷取應用程式的事件資料流的相關資訊	讀取	event-stream*
GetExportJob	准許取得特定匯出任務的相關資訊	讀取	export-job*
GetExportJobs	准許擷取應用程式的所有匯出任務的清單	列出	app*
GetGcmChannel	准許擷取應用程式的 GCM 頻道的相關資訊	讀取	channel*
GetImportJob	准許擷取特定匯入任務的相關資訊	讀取	import-job*
GetImportJobs	准許擷取應用程式的所有匯入任務的相關資訊	列出	app*
GetInAppMessages	准許擷取指定端點 ID 的應用程式內訊息	讀取	app*
GetInAppTemplate	准許擷取應用程式內訊息範本特定版本或使用中版本的相關資訊	讀取	template*
GetJourney	准許擷取特定行程的相關資訊	讀取	journey*
GetJourneyDateRangeKpi	准許擷取 (查詢) 適用於行程之標準參與指標的預先彙總資料	讀取	journey-metrics*
GetJourneyExecutionActivityMetrics	准許擷取 (查詢) 適用於行程活動之標準執行指標的預先彙總資料	讀取	journey-execution-activity-metrics*
GetJourneyExecutionMetrics	准許擷取 (查詢) 適用於行程之標準執行指標的預先彙總資料	讀取	journey-execution-metrics*
GetJourneyRunExecutionActivityMetrics	准許擷取 (查詢) 單個旅程執行的旅程活動所套用的標準執行指標的預先彙總資料	讀取	journey*
GetJourneyRunExecutionMetrics	准許擷取 (查詢) 單個旅程執行的旅程所套用的標準執行指標的預先彙總資料	讀取	journey*
GetJourneyRuns	准許擷取旅程的所有旅程執行的相關資訊	清單	journey*
GetPushTemplate	准許擷取推送通知範本特定版本或使用中版本的相關資訊	讀取	template*
GetRecommenderConfiguration	准許擷取建議者模型的 Amazon Pinpoint 組態的相關資訊	讀取	recommender*
GetRecommenderConfigurations	准許擷取與 Amazon Pinpoint 帳戶相關聯之所有建議者模型組態的相關資訊	清單	recommenders*
GetReports [僅限許可]	授予移動設定的權限：GetReports	讀取	reports*
GetSegment	准許擷取特定客群的相關資訊	讀取	segment*
GetSegmentExportJobs	准許針對將端點定義從客群匯出到 Amazon S3 的任務擷取相關資訊	列出	segment*
GetSegmentImportJobs	准許針對匯入端點定義來建立客群的任務擷取相關資訊	列出	segment*
GetSegmentVersion	准許擷取特定客群版本的相關資訊	讀取	segment*
GetSegmentVersions	准許擷取客群的目前和之前版本的相關資訊	列出	segment*
GetSegments	准許擷取應用程式的客群的相關資訊	列出	app*
GetSmsChannel	准許取得應用程式中簡訊頻道的相關資訊	讀取	channel*
GetSmsTemplate	准許擷取簡訊範本特定版本或使用中版本的相關資訊	讀取	template*
GetUserEndpoints	准許擷取與使用者 ID 相關聯的端點的相關資訊	讀取	user*
GetVoiceChannel	准許取得應用程式中語音頻道的相關資訊	讀取	channel*
GetVoiceTemplate	准許擷取語音訊息範本特定版本或使用中版本的相關資訊	讀取	template*
ListJourneys	准許擷取應用程式所有行程的相關資訊	列出	app*
ListTagsForResource	准許列出資源的標籤	讀取	app
			campaign
			journey
			segment
			template
ListTemplateVersions	准許擷取特定範本的所有版本	列出	template*
ListTemplates	准許擷取有關所查詢範本的中繼資料	列出	templates*
PhoneNumberValidate	准許取得電話號碼的中繼資料，例如號碼類型 (行動電話、有線電話或 VoIP)、位置和供應商	讀取	phone-number-validate*
PutEventStream	准許建立或更新應用程式的事件資料流	寫入	event-stream*
PutEvents	准許建立或更新應用程式的事件	寫入	events*
RemoveAttributes	准許移除應用程式的屬性	寫入	attribute*
SendMessages	准許將簡訊或推送通知傳送到特定端點	寫入	messages*
SendOTPMessage	准許傳送 OTP 代碼至應用程式的使用者	寫入	otp*
SendUsersMessages	准許將簡訊或推送通知傳送到與特定使用者 ID 相關聯的所有端點	寫入	messages*
TagResource	准許將 標籤新增至資源	標記	app
			campaign
			journey
			segment
			template
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	授予許可來從資源中移除標籤	標記	app
			campaign
			journey
			segment
			template
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateAdmChannel	准許更新應用程式的 Amazon Device Messaging (ADM) 頻道	寫入	channel*
UpdateApnsChannel	准許更新應用程式的 Apple 推送通知服務 (APNs) 頻道	寫入	channel*
UpdateApnsSandboxChannel	准許更新應用程式的 Apple 推送通知服務 (APNs) 沙盒頻道	寫入	channel*
UpdateApnsVoipChannel	准許更新應用程式的 Apple 推送通知服務 (APNs) VoIP 頻道	寫入	channel*
UpdateApnsVoipSandboxChannel	准許更新應用程式的 Apple 推送通知服務 (APNs) VoIP 沙盒頻道	寫入	channel*
UpdateApplicationSettings	准許更新應用程式的預設設定	寫入	app*
UpdateBaiduChannel	准許更新應用程式的 Baidu 頻道	寫入	channel*
UpdateCampaign	准許更新特定行銷活動	寫入	campaign*
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateEmailChannel	准許更新應用程式的電子郵件頻道	寫入	channel*
UpdateEmailTemplate	准許更新相同版本下的特定電子郵件範本或產生新版本	寫入	template*
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateEndpoint	准許建立端點或更新端點的資訊	寫入	endpoint*
UpdateEndpointsBatch	准許以批次操作來建立或更新端點	寫入	app*
UpdateGcmChannel	准許更新 Firebase Cloud Messaging (FCM) 或 Google Cloud Messaging (GCM) API 金鑰，此金鑰允許將推送通知傳送到 Android 應用程式	寫入	channel*
UpdateInAppTemplate	准許更新相同版本下的特定應用程式內訊息範本或產生新版本	寫入	template*
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateJourney	准許更新特定行程	寫入	journey*
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateJourneyState	准許更新特定行程狀態	寫入	journey*
				aws:RequestTag/${TagKey} aws:TagKeys
UpdatePushTemplate	准許更新相同版本下的特定推送通知範本或產生新版本	寫入	template*
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateRecommenderConfiguration	准許更新建議者模型的 Amazon Pinpoint 組態	寫入	recommender*
UpdateSegment	准許更新特定客群	寫入	segment*
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateSmsChannel	准許更新應用程式的簡訊頻道	寫入	channel*
UpdateSmsTemplate	准許更新相同版本下的特定簡訊範本或產生新版本	寫入	template*
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateTemplateActiveVersion	准許更新特定範本的使用中版本參數	寫入	template*
UpdateVoiceChannel	准許更新應用程式的語音頻道	寫入	channel*
UpdateVoiceTemplate	准許更新相同版本下的特定語音訊息範本或產生新版本	寫入	template*
				aws:RequestTag/${TagKey} aws:TagKeys
VerifyOTPMessage	准許檢查一次性密碼 (OTP) 的有效性	寫入	verify-otp*

Amazon Pinpoint 定義的資源類型

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

資源類型	ARN	條件索引鍵
app	arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}	aws:ResourceTag/${TagKey}
apps	arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/*
campaign	arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/campaigns/${CampaignId}	aws:ResourceTag/${TagKey}
journey	arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/journeys/${JourneyId}	aws:ResourceTag/${TagKey}
journeys	arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/journeys
segment	arn:${Partition}:mobiletargeting:${Region}:${Account}:apps/${AppId}/segments/${SegmentId}	aws:ResourceTag/${TagKey}
template	arn:${Partition}:mobiletargeting:${Region}:${Account}:templates/${TemplateName}/${TemplateType}	aws:ResourceTag/${TagKey}
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 元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵資料表。

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

條件索引鍵	描述	Type
aws:RequestTag/${TagKey}	依使用者對 Pinpoint 服務所做請求中存在的索引鍵篩選存取權	字串
aws:ResourceTag/${TagKey}	依標籤鍵值組來篩選存取	字串
aws:TagKeys	依使用者對 Pinpoint 服務所做請求中存在的所有標籤索引鍵名稱清單篩選存取權	ArrayOfString