View a markdown version of this page

用于 IAM 策略的 Amazon Pinpoint 操作 - Amazon Pinpoint

终止支持通知:AWS将于 2026 年 10 月 30 日终止对亚马逊 Pinpoint 的支持。2026 年 10 月 30 日之后,您将不再能够访问 Amazon Pinpoint 控制台或 Amazon Pinpoint 资源(端点、分段、活动、旅程和分析)。有关更多信息,请参阅 Amazon Pinpoint 终止支持注意:与短信、语音、移动推送、OTP 和电话号码验证相关的 API 不受此变更的影响,AWS最终用户消息支持这些接口。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

用于 IAM 策略的 Amazon Pinpoint 操作

要管理对您AWS账户中亚马逊 Pinpoint 资源的访问权限,您可以在 (IAM) 策略中添加亚马逊 Pinpoint 操作AWS Identity and Access Management。通过在策略中使用操作,您可以控制用户可以在 Amazon Pinpoint 控制台上执行的操作。您还可以直接使用软件AWS开发工具包、AWS Command Line Interface(AWS CLI) 或 Amazon Pinpoint API,以编程方式控制用户可以执行的操作。

在策略中,可以使用后跟冒号和操作名称(如 GetSegments)的适当 Amazon Pinpoint 命名空间指定每个操作。大多数操作都与使用特定 URI 和 HTTP 方法对 Amazon Pinpoint API 进行的请求相对应。例如,如果您在用户的策略中允许 mobiletargeting:GetSegments 操作,则允许用户通过向 /apps/projectId/segments URI 提交 HTTP GET 请求来检索有关项目所有分段的信息。此策略还允许用户在控制台上查看该信息,并使用AWS软件开发工具包或检索该信息AWS CLI。

每个操作在特定 Amazon Pinpoint 资源 (在策略语句中通过 Amazon 资源名称 (ARN) 来标识) 上执行。例如,mobiletargeting:GetSegments 操作在使用 ARN arn:aws:mobiletargeting:region:accountId:apps/projectId 标识的特定项目上执行。

本主题介绍您可以添加到AWS账户的 IAM 策略的 Amazon Pinpoint 操作。要查看有关如何使用策略中的操作来管理对 Amazon Pinpoint 资源的访问的示例,请参阅 Amazon Pinpoint 基于身份的策略示例

Amazon Pinpoint API 操作

本节介绍 Amazon Pinpoint API 中提供的功能的操作,该 API 是 Amazon Pinpoint 的主要 API。要了解有关此 API 的更多信息,请参阅 Amazon Pinpoint API 参考

分析和指标

以下权限与在 Amazon Pinpoint 控制台上查看分析数据相关。它们还与检索(查询)适用于项目、活动和旅程的标准指标的聚合数据相关,这些指标也称为关键绩效指标 (KPI)

mobiletargeting:GetReports

在 Amazon Pinpoint 控制台上查看分析数据。要使用 Amazon Pinpoint 控制台创建包含自定义属性的分段,也需要此权限。要在 Amazon Pinpoint 控制台中获取分段大小的估计值,同样需要此权限。

  • URI – 不适用

  • 方法 – 不适用

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:*

mobiletargeting:GetApplicationDateRangeKpi

检索(查询)标准应用程序指标的聚合数据。这是适用于与某个项目关联的所有活动或事务性消息的指标。

mobiletargeting:GetCampaignDateRangeKpi

检索(查询)标准活动指标的聚合数据。这是适用于单个活动的指标。

mobiletargeting:GetJourneyDateRangeKpi

检索(查询)标准旅程参与指标的聚合数据。这是适用于单独旅程的参与度指标,例如,对于某个旅程的所有活动,参与者打开的消息的数量。

mobiletargeting:GetJourneyExecutionMetrics

检索(查询)适用于单独旅程的标准执行指标的汇总数据,例如,对于某个旅程的所有活动,积极推进各项活动的参与者的数量。

mobiletargeting:GetJourneyExecutionActivityMetrics

检索(查询)适用于旅程中单个活动的标准执行指标的汇总数据,例如,开始或完成某项活动的参与者的数量。

市场活动

以下权限与管理您的 Amazon Pinpoint 账户中的活动有关。

mobiletargeting:CreateCampaign

为项目创建活动。

  • URI – /apps/projectId/campaigns

  • 方法 – POST

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId/campaigns

mobiletargeting:DeleteCampaign

删除特定活动。

mobiletargeting:GetCampaign

检索有关特定活动的信息。

mobiletargeting:GetCampaignActivities

检索有关活动执行的活动的信息。

mobiletargeting:GetCampaigns

检索有关项目的所有活动的信息。

mobiletargeting:GetCampaignVersion

检索有关特定活动版本的信息。

mobiletargeting:GetCampaignVersions

检索有关活动的当前和以前版本的信息。

mobiletargeting:UpdateCampaign

更新特定活动。

渠道

以下权限与管理您的 Amazon Pinpoint 账户中的渠道有关。在 Amazon Pinpoint 中,渠道 是指您用于联系客户的方法,例如发送电子邮件、短信或推送通知。

mobiletargeting:DeleteAdmChannel

禁用项目的 Amazon Device Messaging (ADM) 渠道。

  • URI – /apps/projectId/channels/adm

  • 方法 – DELETE

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId/channels/adm

mobiletargeting:GetAdmChannel

检索有关项目的 ADM 渠道的信息。

mobiletargeting:UpdateAdmChannel

启用或更新项目的 ADM 渠道。

mobiletargeting:DeleteApnsChannel

禁用项目的 Apple Push Notification service (APNs) 渠道。

mobiletargeting:GetApnsChannel

检索有关项目的 APNs 渠道的信息。

mobiletargeting:UpdateApnsChannel

启用或更新项目的 APNs 渠道。

mobiletargeting:DeleteApnsSandboxChannel

禁用项目的 APNs 沙盒渠道。

mobiletargeting:GetApnsSandboxChannel

检索有关项目的 APNs 沙盒渠道的信息。

mobiletargeting:UpdateApnsSandboxChannel

启用或更新项目的 APNs 沙盒渠道。

mobiletargeting:DeleteApnsVoipChannel

禁用项目的 APNs VoIP 渠道。

mobiletargeting:GetApnsVoipChannel

检索有关项目的 APNs VoIP 渠道的信息。

mobiletargeting:UpdateApnsVoipChannel

启用或更新项目的 APNs VoIP 渠道。

mobiletargeting:DeleteApnsVoipSandboxChannel

禁用项目的 APNs VoIP 沙盒渠道。

mobiletargeting:GetApnsVoipSandboxChannel

检索有关项目的 APNs VoIP 沙盒渠道的信息。

mobiletargeting:UpdateApnsVoipSandboxChannel

启用或更新项目的 APNs VoIP 沙盒渠道。

mobiletargeting:DeleteBaiduChannel

禁用项目的百度云推送渠道。

mobiletargeting:GetBaiduChannel

检索有关项目的百度云推送渠道的信息。

mobiletargeting:UpdateBaiduChannel

启用或更新项目的百度云推送渠道。

mobiletargeting:DeleteEmailChannel

禁用项目的电子邮件渠道。

mobiletargeting:GetEmailChannel

检索有关项目的电子邮件渠道的信息。

mobiletargeting:UpdateEmailChannel

启用或更新项目的电子邮件渠道。

mobiletargeting:DeleteGcmChannel

禁用项目的 Firebase Cloud Messaging (FCM) 渠道。该渠道允许 Amazon Pinpoint 通过 FCM 服务将推送通知发送到 Android 应用程序,FCM 服务取代了 Google Cloud Messaging (GCM) 服务。

  • URI – /apps/projectId/channels/gcm

  • 方法 – DELETE

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId/channels/gcm

mobiletargeting:GetGcmChannel

检索有关项目的 FCM 渠道的信息。该渠道允许 Amazon Pinpoint 通过 FCM 服务将推送通知发送到 Android 应用程序,FCM 服务取代了 Google Cloud Messaging (GCM) 服务。

mobiletargeting:UpdateGcmChannel

启用或更新项目的 FCM 渠道。该渠道允许 Amazon Pinpoint 通过 FCM 服务将推送通知发送到 Android 应用程序,FCM 服务取代了 Google Cloud Messaging (GCM) 服务。

mobiletargeting:DeleteSmsChannel

禁用项目的短信渠道。

  • URI – /apps/projectId/channels/sms

  • 方法 – DELETE

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId/channels/sms

mobiletargeting:GetSmsChannel

检索有关项目的短信渠道的信息。

mobiletargeting:UpdateSmsChannel

启用或更新项目的短信渠道。

mobiletargeting:GetChannels

检索有关应用程序的每个渠道的历史和状态的信息。

mobiletargeting:DeleteVoiceChannel

禁用应用程序的语音渠道并删除该渠道的任何现有设置。

mobiletargeting:GetVoiceChannel

检索有关应用程序的语音渠道的状态和设置的信息。

mobiletargeting:UpdateVoiceChannel

启用应用程序的语音渠道或更新应用程序语音渠道的状态和设置。

端点

以下权限与管理您的 Amazon Pinpoint 账户中的端点有关。在 Amazon Pinpoint 中,端点 是您的消息的一个目的地。例如,端点可能是客户的电子邮件地址、电话号码或移动设备令牌。

mobiletargeting:DeleteEndpoint

删除端点。

mobiletargeting:GetEndpoint

检索有关特定端点的信息。

mobiletargeting:RemoveAttributes

从与某个应用程序关联的所有端点中移除一个或多个具有相同属性类型的属性。

mobiletargeting:UpdateEndpoint

创建端点或更新端点的信息。

mobiletargeting:UpdateEndpointsBatch

以批处理操作形式创建或更新端点。

事件流

以下权限与管理您的 Amazon Pinpoint 账户的事件流有关。

mobiletargeting:DeleteEventStream

删除项目的事件流。

mobiletargeting:GetEventStream

检索有关项目的事件流的信息。

mobiletargeting:PutEventStream

创建或更新项目的事件流。

事件

以下权限与管理您的 Amazon Pinpoint 账户中的事件任务有关。在 Amazon Pinpoint 中,您可以创建导入任务,以根据存储在 Amazon S3 存储桶中的端点定义创建分段。

mobiletargeting:PutEvents

为端点创建要记录的新事件,或者创建或更新与现有事件关联的端点数据。

导出任务

以下权限与管理您的 Amazon Pinpoint 账户中的导出任务有关。在 Amazon Pinpoint 中,您可以创建导出任务,以将有关端点的信息发送到 Amazon S3 存储桶进行存储或分析。

mobiletargeting:CreateExportJob

创建导出任务以将端点定义导出到 Amazon S3。

  • URI – /apps/projectId/jobs/export

  • 方法 – POST

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId/jobs/export

mobiletargeting:GetExportJob

检索有关项目的特定导出任务的信息。

mobiletargeting:GetExportJobs

检索项目的所有导出任务的列表。

  • URI – /apps/projectId/jobs/export

  • 方法 – GET

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId/jobs/export

导入任务

以下权限与管理您的 Amazon Pinpoint 账户中的导入任务有关。在 Amazon Pinpoint 中,您可以创建导入任务,以根据存储在 Amazon S3 存储桶中的端点定义创建分段。

mobiletargeting:CreateImportJob

从 Amazon S3 导入端点定义以创建分段。

mobiletargeting:GetImportJob

检索有关项目的特定导入任务的信息。

mobiletargeting:GetImportJobs

检索有关项目的所有导入任务的信息。

Journeys

以下权限与管理您的 Amazon Pinpoint 账户中的旅程相关。

mobiletargeting:CreateJourney

为项目创建旅程。

  • URI – /apps/projectId/journeys

  • 方法 – POST

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId/journeys

mobiletargeting:GetJourney

检索有关特定旅程的信息。

mobiletargeting:ListJourneys

检索有关项目的所有旅程的信息。

  • URI – /apps/projectId/journeys

  • 方法 – GET

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId/journeys

mobiletargeting:UpdateJourney

更新特定旅程的配置和其他设置。

mobiletargeting:UpdateJourneyState

取消活动旅程。

mobiletargeting:DeleteJourney

删除特定旅程。

消息模板

以下权限与为您的 Amazon Pinpoint 账户创建和管理消息模板有关。消息模板 是一组内容和设置,您可以在为任何 Amazon Pinpoint 项目发送的消息中定义、保存和重用它们。

mobiletargeting:ListTemplates

检索有关与您的 Amazon Pinpoint 账户关联的所有消息模板的信息。

  • URI – /templates

  • 方法 – GET

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:templates

mobiletargeting:ListTemplateVersions

检索有关特定消息模板的所有版本的信息。

mobiletargeting:UpdateTemplateActiveVersion

将消息模板的特定版本指定为模板的活动版本。

mobiletargeting:GetEmailTemplate

检索有关通过电子邮件渠道发送的消息的消息模板的信息。

mobiletargeting:CreateEmailTemplate

为通过电子邮件渠道发送的消息创建消息模板。

mobiletargeting:UpdateEmailTemplate

更新通过电子邮件渠道发送的消息的现有消息模板。

mobiletargeting:DeleteEmailTemplate

删除通过电子邮件渠道发送的消息的消息模板。

mobiletargeting:GetPushTemplate

检索有关通过推送通知渠道发送的消息的消息模板的信息。

mobiletargeting:CreatePushTemplate

为通过推送通知渠道发送的消息创建消息模板。

mobiletargeting:UpdatePushTemplate

更新通过推送通知渠道发送的消息的现有消息模板。

mobiletargeting:DeletePushTemplate

删除通过推送通知渠道发送的消息的消息模板。

mobiletargeting:GetSmsTemplate

检索有关通过短信渠道发送的消息的消息模板的信息。

mobiletargeting:CreateSmsTemplate

为通过短信渠道发送的消息创建消息模板。

mobiletargeting:UpdateSmsTemplate

更新通过短信渠道发送的消息的现有消息模板。

mobiletargeting:DeleteSmsTemplate

删除通过短信渠道发送的消息的消息模板。

  • URI – /templates/template-name/sms

  • 方法 – DELETE

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:templates/template-name/SMS

mobiletargeting:GetVoiceTemplate

检索有关通过语音渠道发送的消息的消息模板的信息。

mobiletargeting:CreateVoiceTemplate

为通过语音渠道发送的消息创建消息模板。

mobiletargeting:UpdateVoiceTemplate

更新通过语音渠道发送的消息的现有消息模板。

mobiletargeting:DeleteVoiceTemplate

删除通过语音渠道发送的消息的消息模板。

消息

以下权限与从您的 Amazon Pinpoint 账户发送消息和推送通知有关。您可以使用 SendMessagesSendUsersMessages 操作将消息发送到特定端点,而不先创建分段和活动。

mobiletargeting:SendMessages

将消息或推送通知发送到特定端点。

  • URI – /apps/projectId/messages

  • 方法 – POST

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId/messages

mobiletargeting:SendUsersMessages

向与特定用户 ID 关联的所有端点发送消息或推送通知。

One-time 密码

以下权限与在 Amazon Pinpoint 中发送和验证一次性密码 (OTP) 有关。

mobiletargeting:SendOTPMessage

发送包含一次性密码的文本消息。

  • URI – /apps/projectId/otp

  • 方法 – POST

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId/otp

mobiletargeting:VerifyOTPMessage

检查使用 SendOTPMessage 操作生成的一次性密码 (OTP) 的有效性。

  • URI – /apps/projectId/verify-otp

  • 方法 – POST

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId/verify-otp

电话号码验证

以下权限与使用 Amazon Pinpoint 中的电话号码验证服务有关。

mobiletargeting:PhoneNumberValidate

检索有关电话号码的信息。

  • URI – /phone/number/validate

  • 方法 – POST

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:phone/number/validate

Projects

以下权限与管理您的 Amazon Pinpoint 账户中的项目有关。最初,项目被称为应用程序。出于这些操作的目的,Amazon Pinpoint 应用程序与 Amazon Pinpoint 项目是一回事。

mobiletargeting:CreateApp

创建 Amazon Pinpoint 项目。

  • URI – /apps

  • 方法 – POST

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps

mobiletargeting:DeleteApp

删除 Amazon Pinpoint 项目。

  • URI – /apps/projectId

  • 方法 – DELETE

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId

mobiletargeting:GetApp

检索有关 Amazon Pinpoint 项目的信息。

  • URI – /apps/projectId

  • 方法 – GET

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId

mobiletargeting:GetApps

检索有关与您的 Amazon Pinpoint 账户关联的所有项目的信息。

  • URI – /apps

  • 方法 – GET

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps

mobiletargeting:GetApplicationSettings

检索 Amazon Pinpoint 项目的默认设置。

  • URI – /apps/projectId/settings

  • 方法 – GET

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId

mobiletargeting:UpdateApplicationSettings

更新 Amazon Pinpoint 项目的默认设置。

  • URI – /apps/projectId/settings

  • 方法 – PUT

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId

推荐器模型

以下权限与管理 Amazon Pinpoint 配置以从推荐器模型中检索和处理推荐数据有关。推荐器模型 是一种机器学习模型,可以查找数据中的模式以预测和生成个性化建议。

mobiletargeting:CreateRecommenderConfiguration

为推荐器模型创建 Amazon Pinpoint 配置。

  • URI – /recommenders

  • 方法 – POST

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:recommenders

mobiletargeting:GetRecommenderConfigurations

检索有关与 Amazon Pinpoint 账户关联的所有推荐器模型配置的信息。

  • URI – /recommenders

  • 方法 – GET

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:recommenders

mobiletargeting:GetRecommenderConfiguration

检索有关某个推荐器模型的单独 Amazon Pinpoint 配置的信息。

  • URI – /recommenders/recommenderId

  • 方法 – GET

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:recommenders/recommenderId

mobiletargeting:UpdateRecommenderConfiguration

更新推荐器模型的 Amazon Pinpoint 配置。

  • URI – /recommenders/recommenderId

  • 方法 – PUT

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:recommenders/recommenderId

mobiletargeting:DeleteRecommenderConfiguration

删除推荐器模型的 Amazon Pinpoint 配置。

  • URI – /recommenders/recommenderId

  • 方法 – DELETE

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:recommenders/recommenderId

Segments

以下权限与管理您的 Amazon Pinpoint 账户中的分段有关。在 Amazon Pinpoint 中,分段 是您的活动中具有您定义的某些共同属性的接收人组。

mobiletargeting:CreateSegment

创建分段。要允许用户通过从 Amazon Pinpoint 外部导入端点数据来创建分段,请允许 mobiletargeting:CreateImportJob 操作。

  • URI – /apps/projectId/segments

  • 方法 – POST

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId

mobiletargeting:DeleteSegment

删除分段。

mobiletargeting:GetSegment

检索有关特定分段的信息。

mobiletargeting:GetSegmentExportJobs

检索有关为分段导出端点定义的任务的信息。

mobiletargeting:GetSegments

检索有关项目的所有分段的信息。

  • URI – /apps/projectId/segments

  • 方法 – GET

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId

mobiletargeting:GetSegmentImportJobs

检索有关通过从 Amazon S3 导入端点定义来创建分段的任务的信息。

mobiletargeting:GetSegmentVersion

检索有关特定分段版本的信息。

mobiletargeting:GetSegmentVersions

检索有关分段的当前和以前版本的信息。

mobiletargeting:UpdateSegment

更新特定分段。

标签

以下权限与查看和管理 Amazon Pinpoint 资源的标签有关。

mobiletargeting:ListTagsForResource

检索有关与项目、活动、消息模板或分段关联的标签的信息。

  • URI – /tags/resource-arn

  • 方法 – GET

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:*

mobiletargeting:TagResource

向项目、活动、消息模板或分段添加一个或多个标签。

  • URI – /tags/resource-arn

  • 方法 – POST

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:*

mobiletargeting:UntagResource

从项目、活动、消息模板或分段中删除一个或多个标签。

  • URI – /tags/resource-arn

  • 方法 – DELETE

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:*

Users

以下权限与管理用户有关。在 Amazon Pinpoint 中,用户对应于收到您的消息的个人。单个用户可能与多个端点关联。

mobiletargeting:DeleteUserEndpoints

删除与用户 ID 关联的所有端点。

  • URI – /apps/projectId/users/userId

  • 方法 – DELETE

  • 资源 ARN – arn:aws:mobiletargeting:region:accountId:apps/projectId/users/userId

mobiletargeting:GetUserEndpoints

检索与用户 ID 关联的所有端点的相关信息。

Amazon Pinpoint SMS 和 Voice API 第 1 版操作

本节介绍 Amazon Pinpoint SMS 和 Voice API 中提供的功能的操作。这是一个补充 API,它提供在 Amazon Pinpoint 中使用和管理短信和语音渠道的高级选项。要了解有关此 API 的更多信息,请参阅 Amazon Pinpoint SMS 和 Voice API 参考

sms-voice:CreateConfigurationSet

创建配置集以发送语音消息。

  • URI – /sms-voice/configuration-sets

  • 方法 – POST

  • 资源 ARN – 不可用。使用 *

sms-voice:DeleteConfigurationSet

删除配置集以发送语音消息。

  • URI — /sms---sets/ voice/configuration ConfigurationSetName

  • 方法 – DELETE

  • 资源 ARN – 不可用。使用 *

sms-voice:GetConfigurationSetEventDestinations

检索有关配置集及其包含的事件目标的信息。

  • URI — /sms--sets/ /event-destinations voice/configuration ConfigurationSetName

  • 方法 – GET

  • 资源 ARN – 不可用。使用 *

sms-voice:CreateConfigurationSetEventDestination

为语音事件创建事件目标。

  • URI — /sms--sets/ /event-destinations voice/configuration ConfigurationSetName

  • 方法 – POST

  • 资源 ARN – 不可用。使用 *

sms-voice:UpdateConfigurationSetEventDestination

为语音事件更新事件目标。

  • URI — /sms--sets/ /event-destinations/ voice/configuration ConfigurationSetName EventDestinationName

  • 方法 – PUT

  • 资源 ARN – 不可用。使用 *

sms-voice:DeleteConfigurationSetEventDestination

删除语音事件的事件目标。

  • URI — /sms--sets/ /event-destinations/ voice/configuration ConfigurationSetName EventDestinationName

  • 方法 – DELETE

  • 资源 ARN – 不可用。使用 *

sms-voice:SendVoiceMessage

创建和发送语音消息。

  • URI — /sms-/messag voice/voice e

  • 方法 – POST

  • 资源 ARN – 不可用。使用 *