以编程方式向 Amazon Pinpoint 资源添加标签 - Amazon Pinpoint

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

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

以编程方式向 Amazon Pinpoint 资源添加标签

以下示例展示了如何使用 AWS CLIAmazon Pinpoint REST API 向 Amazon Pinpoint 资源添加标签。您也可以使用任何支持的 AWS SDK 为资源添加标签。

要在单个操作中向多个 Amazon Pinpoint 资源添加标签,请使用 AWS CLI 或标记 API 的资源组标记操作。AWS Resource Groups

使用 API 添加标签

要使用 Amazon Pinpoint REST API 创建新资源并为它添加标签,请向相应的资源 URI 发送 POST 请求。在请求的正文中,请包括 tags 参数和值。以下示例显示如何在创建新项目时指定标签。

POST /v1/apps HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com Content-Type: application/x-www-form-urlencoded Accept: application/json Cache-Control: no-cache { "Name":"MyProject", "tags":{ "key1":"value1" } }

要向现有资源添加标签,请向标签 URI 发送 POST 请求。在 URI 中包含资源的 Amazon 资源名称(ARN)。ARN 应采用 URL 编码。在请求的正文中,请包含 tags 参数和值,如以下示例所示。

POST /v1/tags/resource-arn HTTP/1.1 Host: pinpoint.us-east-1.amazonaws.com Content-Type: application/json Accept: application/json Cache-Control: no-cache { "tags":{ "key1":"value1" } }

使用添加标签 AWS CLI

要使用创建新资源并向其添加标签 AWS CLI,请对该资源使用相应的create命令。包括 tags 参数和值。以下示例显示在创建新项目时如何指定标签。

Linux, macOS, or Unix
$ aws pinpoint create-app \ --create-application-request '{ "Name":"MyProject", "tags": { "key1":"value1", "key2":"value2" } }'
Windows Command prompt
C:\> aws pinpoint create-app ^ --create-application-request Name=MyProject,tags={key1=value1,key2=value2}

在上述示例中,执行以下操作:

  • MyProject替换为要为项目命名的名称。

  • key1key2替换为要添加到资源中的标签的密钥。

  • value2用要为相应密钥添加的标签值替换value1和。

有关可用来创建 Amazon Pinpoint 资源的命令的信息,请参阅 AWS CLI 命令参考

要向现有资源添加标签,请使用 tag-resource 命令并为必需参数指定相应的值:

Linux, macOS, or Unix
$ aws pinpoint tag-resource \ --resource-arn resource-arn \ --tags-model '{ "tags": { "key1":"value1", "key2":"value2" } }'
Windows Command Prompt
C:\> aws pinpoint tag-resource ^ --resource-arn resource-arn ^ --tags-model tags={key1=value1,key2=value2}

在上述示例中,执行以下操作:

  • resource-arn替换为您要添加标签的资源的 Amazon 资源名称 (ARN)。

  • key1key2替换为要添加到资源中的标签的密钥。

  • value2用要为相应密钥添加的标签值替换value1和。