View a markdown version of this page

TagResource - Amazon Forecast

新客户不再可以使用亚马逊 Forecast。Amazon Forecast 的现有客户可以继续照常使用该服务。了解更多

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

TagResource

将指定的标签与具有指定 resourceArn 的资源相关联。如果未在请求参数中指定资源上的现有标签,则不会更改这些标签。在删除一项资源时,与该资源关联的标签也将删除。

重要

Amazon Forecast 不再向新客户提供。Amazon Forecast 的现有客户可以继续照常使用该服务。了解更多

请求语法

{ "ResourceArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

请求参数

请求接受采用 JSON 格式的以下数据。

ResourceArn

标识要列出其标签的资源的 Amazon 资源名称(ARN)。

类型:字符串

长度约束:最大长度为 256。

模式:arn:([a-z\d-]+):forecast:.*:.*:.+

是否必需:是

Tags

要添加到该资源的标签。标签是键值对的数组。

下面是适用于 标签的基本限制:

  • 每个资源的最大标签数 - 50。

  • 对于每个资源,每个标签密钥必须是唯一的,并且每个标签密钥只能有一个值。

  • 最大密钥长度-包含 128 个 Unicode 字符。 UTF-8

  • 最大值长度-以 256 个 Unicode 字符为单位。 UTF-8

  • 如果标签方案针对多个服务和资源使用,请记得其他服务可能对支持的字符有限制。通常允许使用的字符有:字母、数字和可表示的空格 UTF-8,以及以下字符:+-=. _:/@。

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

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

类型:Tag 对象数组

数组成员:最少 0 个物品。最多 200 项。

是否必需:是

响应元素

如果此操作成功,则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。

错误

InvalidInputException

我们无法处理该请求,因为其包含无效值或超出有效范围的值。

HTTP 状态代码:400

LimitExceededException

超过了每个账户的资源数量限制。

HTTP 状态代码:400

ResourceNotFoundException

我们找不到具有该 Amazon 资源名称(ARN)的资源。检查 ARN,然后重试。

HTTP 状态代码:400

另请参阅

有关在某个特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: