TagResource - Amazon Forecast
请求语法请求参数响应元素错误另请参阅

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

TagResource

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

请求语法

{
   "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 的更多信息，请参阅以下内容：