为 Amazon Forecast 资源贴标签

标签是您可以选择性定义并与 AWS 资源（包括某些类型的 Amazon Forecast 资源）关联的标签。标签可帮助您以不同方式（例如按用途、所有者、环境或其他标准）对资源类型进行分类和管理。例如，您可以使用标签来应用策略或自动化，或用于标识要满足某些合规性要求的资源。您可以向以下 Forecast 资源类型添加标签：

• 数据集组

• 数据集

• 数据集导入作业

• 预测器

• 预测器导出作业

• 预测

• 预测导出作业

• 假设分析

• 假设分析预测

• 假设分析预测导出作业

一个资源可具有最多 50 个标签。

管理标签

每个标签都包含您定义的一个标签键和一个可选的标签值。标签键是一种常见的标签，充当更具体的标签值的类别。标签值 充当标签键的描述符。例如，如果您的 Forecast 数据集导入作业有两个版本，一个用于内部测试，另一个供生产使用，则您可为这两个项目分配一个 Environment 标签键。Environment 标签键的值，对于数据集导入作业的一个版本可以为 Test，对于另一个版本可以为 Production。

一个标签键可以包含多达 128 个字符。一个标签值可以包含多达 256 个字符。字符可以是 Unicode 字母、数字、空格或以下任一个符号：_ . : / = + -。以下附加限制适用于标签：

• 标签键和值区分大小写。

• 对于每个关联的资源，每个标签键都必须是唯一的，并且只能有一个值。

• 请不要使用 aws:、AWS: 或任何大写或小写组合（例如，键的前缀），因为它将保留以供 AWS 使用。不能编辑或删除带此前缀的标签键。值可以带有该前缀。如果标签值将 aws 作为其前缀，但键没有前缀，则 Forecast 会将其视为用户标签，并将计入 50 个标签的限制。仅具有 aws 的键前缀的标签不计入每个资源的标签数限制。

• 您无法仅根据其标签更新或删除资源。您还必须指定 Amazon 资源名称 (ARN) 或资源 ID，具体取决于您使用的操作。

• 您可以将标签与公共资源或共享资源相关联。但是，这些标签仅适用于您的 AWS 账户，不适用于共享该资源的任何其他账户。此外，标签仅适用于位于您的 AWS 账户 所指定 AWS 区域 中的资源。

要在 Forecast 资源中添加、显示、更新和删除标签键和值，您可以使用 AWS Command Line Interface (AWS CLI)、 Forecast API、或 AWS 开发工具包。

在 IAM 策略中使用标签

开始实施标签后，您可以向 AWS Identity and Access Management (IAM) 策略和 API 操作应用基于标记的资源级权限。这包括支持在创建资源时为资源添加标签的操作。通过这种方式使用标签，您可以更全面地控制 AWS 账户 中的哪些组和用户拥有创建和标记资源的权限，以及哪些组和用户拥有创建、更新和删除标签的权限。

例如，您可以创建一个策略，允许用户只要其名称是资源的 Owner 标签中的值，就可以完全访问这些 Forecast 资源。

{
   "Version": "2012-10-17",
   "Statement": [
      {
         "Sid": "ModifyResourceIfOwner",
         "Effect": "Allow",
         "Action": "forecast:*",
         "Resource": "*",
         "Condition": {
            "StringEqualsIgnoreCase": {
               "aws:ResourceTag/Owner": "${aws:username}"
            }
         }
      }
   ]
}

以下示例演示如何创建允许创建和删除数据集的策略。只有在用户名为 johndoe 时，才允许执行这些操作。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "forecast:CreateDataset",
                "forecast:DeleteDataset"
            ],
            "Resource": "arn:aws:forecast:*:*:dataset/*",
            "Condition": {
                "StringEquals": {"aws:username" : "johndoe"}
            }
        },
        {
            "Effect": "Allow",
            "Action": "forecast:DescribeDataset",
            "Resource": "*"
        }
    ]
}

如果您定义基于标签的资源级权限，该权限立即生效。这意味着，您的资源在创建后会更安全，而且您可以快速开始将标签用于新资源。您还可以使用资源级权限来控制哪些标签键和值可以与新的和现有资源关联。有关更多信息，请参阅AWS《IAM 用户指南》中的使用标签控制访问。

向资源添加标签

以下示例说明如何使用 AWS CLI 和 AWS Management Console 向 Forecast 资源添加标签。

AWS CLI

要使用 AWS CLI 创建新的 Forecast 资源并添加标签，请使用资源的相应 create 命令并包括 tags 参数和值。例如，以下命令针对 CUSTOM 域创建一个名为 myDatasetGroup 的新数据集组，并添加以下标签：带有 Test 标签值的 Environment 标签键以及 Owner 标签键和 xyzCorp 值。

aws forecast create-dataset-group \
--dataset-group-name myDatasetGroup \
--dataset-arns arn:aws:forecast:region:acct-id:dataset/dataset_name \
--domain CUSTOM \
--tags Key=Environment,Value=Test Key=Owner,Value=xyzCorp

有关可用来创建 Forecast 资源的命令的信息，请参阅 Forecast AWS CLI 命令参考。

要向现有资源添加标签，请使用 tag-resource 命令并指定资源的 ARN，并在 tags-model 参数中提供标签键和值。

aws forecast tag-resource \
--resource-arn resource ARN \
--tags Key=key,Value=value

AWS Management Console

在 Forecast 中创建资源时，可以添加可选标签。以下示例向数据集组添加标签。向其他资源添加标签也遵循类似的模式。

向新数据集组添加标签

1. 登录到 AWS Management Console 并打开 Amazon Forecast 控制台，网址：https://console.aws.amazon.com/forecast/。

2. 选择 Create dataset group (创建数据集组)。

3. 对于数据集组名称，输入一个名称。

4. 对于预测域，选择一个域。

5. 选择 Add new tag（添加新标签）。

6. 对于键和值，输入对应的值。

   例如，分别为 Environment 和 Test。

7. 要添加更多标签，请选择添加新标签。

   您最多可以为每个资源添加 50 个标签。

8. 选择下一步来继续创建您的资源。

附加信息

有关标签的更多信息，请参阅以下资源。

• AWS 一般参考中的AWS 标签原则

• AWS 标签策略（可下载的 PDF）

• AWS《IAM 用户指南》中的AWS 访问控制

• AWS Organizations 《用户指南》中的AWS 标签策略