我们不再更新 Amazon Machine Learning 服务，也不再接受新用户使用该服务。本文档可供现有用户使用，但我们不会再对其进行更新。有关更多信息，请参阅[什么是 Amazon Machine Learning](https://docs.aws.amazon.com/machine-learning/latest/dg/what-is-amazon-machine-learning.html)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 标记您的 Amazon ML 对象
通过向您的 Amazon Machine Learning (Amazon ML)对象分配带有标签的元数据，整理和管理这些对象。*标签*是您为对象定义的键值对。
除了使用标签来整理和管理 Amazon ML 对象之外，您还可以使用它们来分类和跟踪您的 AWS 成本。当您将标签应用于 AWS 对象（包括 ML 模型）时，您的 AWS 成本分配报告将包括按标签汇总的使用率和成本。通过应用代表业务类别（例如成本中心、应用程序名称或所有者）的标签，您可以整理多种服务的成本。有关更多信息，请参阅 *AWS Billing 用户指南*中的[对自定义账单报告使用成本分配标签](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)。
**Topics**
+ [有关标签的基本知识](#tagging-basics)
+ [标签限制](#tagging-restrictions)
+ [标记 Amazon ML 对象（控制台）](#tagging-console)
+ [标记 Amazon ML 对象 (API)](#tagging-api)
## 有关标签的基本知识
使用标签分类对象可以轻松管理它们。例如，您可以按用途、所有者或环境分类对象。然后，您可以定义一组标签来帮助您按所有者和关联应用程序跟踪模型。下面是几个示例：
+ 项目：项目名称
+ 所有者：名称
+ 用途：营销预测
+ 应用程序：应用程序名称
+ 环境：生产
使用 Amazon ML 控制台或 API 可完成以下任务：
+ 向对象添加标签
+ 查看对象的标签
+ 编辑对象的标签
+ 删除对象的标签
默认情况下，应用到 Amazon ML 对象的标签复制到使用该对象创建的对象。例如，如果 Amazon Simple Storage Service (Amazon S3) 数据源具有“Marketing cost: Targeted marketing campaign”标签，则使用该数据源创建的模型也将具有“Marketing cost: Targeted marketing campaign”，对该模型的评估也是如此。这样，您就可以使用标签跟踪相关对象，如用于营销活动的所有对象。如果标签源之间有冲突，例如某个模型带有标签“Marketing cost: Targeted marketing campaign”，而数据源带有标签“Marketing cost: Target marketing customers”，Amazon ML 应用来自模型的标签。
## 标签限制
以下限制适用于标签。
基本限制:
+ 每个对象的最大标签数为 50。
+ 标签键和值区分大小写。
+ 无法更改或编辑已删除对象的标签。
标签键限制:
+ 每个标签键必须是唯一的。如果您添加的标签具有已使用的键，则您的新标签将覆盖该对象的现有键值对。
+ 标签键不能以 `aws:` 开头，因为此前缀将预留以供 AWS 使用。AWS 将代表您创建以此前缀开头的标签，但您不能编辑或删除这些标签。
+ 标签键的长度必须介于 1 和 128 个 Unicode 字符之间。
+ 标签键必须包含以下字符：Unicode 字母、数字、空格和以下特殊字符：`_ . / = + - @`。
标签值限制:
+ 标签值的长度必须介于 0 和 255 个 Unicode 字符之间。
+ 标签值可以为空。另外，它们必须包含以下字符：Unicode 字母、数字、空格和以下任意特殊字符：`_ . / = + - @`。
## 标记 Amazon ML 对象（控制台）
您可以使用 Amazon ML 控制台查看、添加、编辑和删除标签。
**查看对象的标签（控制台）**
1. 登录 AWS 管理控制台 并打开 Amazon Machine Learning 控制台，网址为[https://console.aws.amazon.com/machinelearning/](https://console.aws.amazon.com/machinelearning/)。
1. 在导航栏中，展开区域选择器并选择一个区域。
1. 在**对象**页面上，选择对象。
1. 滚动到所选对象的**标签**部分。该对象的标签在这一部分的底部列出。
**向对象添加标签（控制台）**
1. 登录 AWS 管理控制台 并打开 Amazon Machine Learning 控制台，网址为[https://console.aws.amazon.com/machinelearning/](https://console.aws.amazon.com/machinelearning/)。
1. 在导航栏中，展开区域选择器并选择一个区域。
1. 在**对象**页面上，选择对象。
1. 滚动到所选对象的**标签**部分。该对象的标签在这一部分的底部列出。
1. 选择 **Add or edit tags**。
1. 在**添加标签**下的**密钥**字段中指定标签键，（可选）在**值**字段中指定标签值，然后选择**应用更改**。
如果未启用**应用更改**按钮，则您指定的标签键或标签值不满足标签限制。有关更多信息，请参阅 [标签限制](#tagging-restrictions)。
1. 要在**标签**部分的列表中查看您的新标签，请刷新页面。
**编辑标签（控制台）**
1. 登录 AWS 管理控制台 并打开 Amazon Machine Learning 控制台，网址为[https://console.aws.amazon.com/machinelearning/](https://console.aws.amazon.com/machinelearning/)。
1. 在导航栏中，展开区域选择器并选择一个区域。
1. 在**对象**页面上，选择对象。
1. 滚动到所选对象的**标签**部分。该对象的标签在这一部分的底部列出。
1. 选择 **Add or edit tags**。
1. 在**已应用标签**下，编辑**值**字段中的标签值，然后选择**应用更改**。
如果未启用**应用更改**按钮，则您指定的标签值不满足标签限制。有关更多信息，请参阅 [标签限制](#tagging-restrictions)。
1. 要在**标签**部分的列表中查看您更新后的标签，请刷新页面。
**删除对象的标签（控制台）**
1. 登录 AWS 管理控制台 并打开 Amazon Machine Learning 控制台，网址为[https://console.aws.amazon.com/machinelearning/](https://console.aws.amazon.com/machinelearning/)。
1. 在导航栏中，展开区域选择器并选择一个区域。
1. 在**对象**页面上，选择对象。
1. 滚动到所选对象的**标签**部分。该对象的标签在这一部分的底部列出。
1. 选择 **Add or edit tags**。
1. 在**已应用标签**下，选择要删除的标签，然后选择**应用更改**。
## 标记 Amazon ML 对象 (API)
您可以使用 Amazon ML API 添加、列出和删除标签。有关示例，请参阅以下文档：
[AddTags](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_AddTags.html)
为指定对象添加或编辑标签。
[DescribeTags](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_DescribeTags.html)
列出指定对象的标签。
[DeleteTags](https://docs.aws.amazon.com/machine-learning/latest/APIReference/API_DeleteTags.html)
删除指定对象的标签。