

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

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

# 以编程方式从 Amazon Pinpoint 资源中删除标签
<a name="tags-remove"></a>

以下示例展示了如何使用 [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) 和 [Amazon Pinpoint REST API](https://docs.aws.amazon.com/pinpoint/latest/apireference/) 从 Amazon Pinpoint 资源中删除标签（包括键和值）。您也可以使用任何支持的 AWS SDK 从资源中移除标签。

[要在单个操作中从多个 Amazon Pinpoint 资源中移除标签，请使用 AWS CLI 或标记 API 的资源组标记操作。AWS Resource Groups](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html)要仅从资源中删除特定标签值（而不是标签键），您可以[更新资源的标签](tags-update.md)。

## 使用 API 删除标签
<a name="tags-remove-api"></a>

要使用 Amazon Pinpoint REST API 从资源中删除标签，请向[标签](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html) URI 发送 DELETE 请求。在此 URI 中，包含要从中删除标签的资源的 Amazon 资源名称 (ARN)，后跟 `tagKeys` 参数和要删除的标签。例如：

```
https://{{endpoint}}/v1/tags/{{resource-arn}}?tagKeys={{key}}
```

 其中：
+ {{endpoint}}是托管资源的 AWS 区域的 Amazon Pinpoint 终端节点。
+ {{resource-arn}}是您要从中移除标签的资源的 ARN。
+ {{key}}是您要从资源中移除的标签。

所有参数都应是 URL 编码的。

要从一个资源中删除多个标签键及其关联值，请为每个要删除的附加标签附上 `tagKeys` 参数，并用和号 (&) 分隔它们。例如：

```
https://{{endpoint}}/v1/tags/{{resource-arn}}?tagKeys={{key1}}&tagKeys={{key2}}
```

所有参数都应是 URL 编码的。

## 使用移除标签 AWS CLI
<a name="tags-remove-cli"></a>

要使用从资源中移除标签 AWS CLI，请运行`untag-resource`命令。命令中包含 `tag-keys` 参数，如以下示例所示。

------
#### [ Linux, macOS, or Unix ]

```
$ aws pinpoint untag-resource \
  --resource-arn {{resource-arn}} \
  --tag-keys {{key1}} {{key2}}
```

------
#### [ Windows Command Prompt ]

```
C:\> aws pinpoint untag-resource ^
     --resource-arn {{resource-arn}} ^
     --tag-keys {{key1}} {{key2}}
```

------

在前面的示例中，进行以下更改：
+ {{resource-arn}}替换为要从中移除标签的资源的 ARN。
+ {{key2}}用要从资源中移除的标签的密钥替换{{key1}}和。