Amazon Forecast 不再向新买家开放。Amazon Forecast 的现有客户可以继续照常使用该服务。[了解更多](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

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

# 为 Amazon Forecast 资源贴标签
<a name="tagging-forecast-resources"></a>

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

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

## 管理标签
<a name="forecast-managing-tags"></a>

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

一个标签键可包含多达 128 个字符。一个标签值可包含多达 256 个字符。字符可以是 Unicode 字母、数字、空格或以下任一个符号：\$1 . : / = \$1 -。以下附加限制适用于标签：
+ 标签键和值区分大小写。
+ 对于每个关联的资源，每个标签键都必须是唯一的，并且只能有一个值。
+ 请勿使用`aws:``AWS:`、或任何大写或小写组合，例如密钥的前缀，因为它是保留供 AWS 使用的。不能编辑或删除带此前缀的标签键。值可以带有该前缀。如果标签值将 `aws` 作为其前缀，但键没有前缀，则 Forecast 会将其视为用户标签，并将计入 50 个标签的限制。仅具有 `aws` 的键前缀的标签不计入每个资源的标签数限制。
+ 您无法仅根据其标签更新或删除资源。您还必须指定 Amazon 资源名称 (ARN) 或资源 ID，具体取决于您使用的操作。
+ 您可以将标签与公共资源或共享资源相关联。但是，这些标签仅适用于您自己 AWS 账户，不适用于共享该资源的任何其他账户。此外，这些标签仅适用于位于 AWS 区域 为您指定的中的资源 AWS 账户。

要在 Forecast 资源中添加、显示、更新和移除标签键和值，可以使用 AWS Command Line Interface (AWS CLI)、Forecast API 或 S AWS DK。

## 在 IAM 策略中使用标签
<a name="tags-iam"></a>

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

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

------
#### [ JSON ]

****  

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

------

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

------
#### [ JSON ]

****  

```
{
    "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 用户指南》*中的[使用标签控制访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)。

## 向资源添加标签
<a name="tags-add"></a>

以下示例说明如何使用 [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/) 和 AWS 管理控制台向 Forecast 资源添加标签。

------
#### [ AWS CLI ]

要在使用创建新 Forecast 资源时添加标签 AWS CLI，请对该资源使用相应的`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 资源的命令的信息，请参阅 Forecas [AWS CLI t 命令参考](https://docs.aws.amazon.com/cli/latest/reference/forecast/)。

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

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

------
#### [ AWS 管理控制台 ]

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

**向新数据集组添加标签**

1. 登录 AWS 管理控制台 并打开 Amazon Forecast 控制台，网址为[https://console.aws.amazon.com/forecast/](https://console.aws.amazon.com/forecast/)。

1. 选择**创建数据集组**。

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

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

1. 选择**添加新标签**。

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

   例如，分别为 **Environment** 和 **Test**。

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

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

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

------

## 附加信息
<a name="tagging-additional-resources-information"></a>

有关标签的更多信息，请参阅以下资源。
+ AWS *AWS 一般*参考中的@@ [标签原则](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)
+ [AWS 标记策略](https://d1.awsstatic.com/whitepapers/aws-tagging-best-practices.pdf)（可下载的 PDF）
+ AWS *AWS IAM 用户指南*中的@@ [访问控制](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)
+ AWS 《*AWS Organizations 用户*指南》中的@@ [标签策略](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_introduction.html)