TagResource - Amazon QuickSight
请求语法URI 请求参数请求正文响应语法响应元素错误另请参阅

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

TagResource

为指定的 Amazon 分配一个或多个标签（键值对） QuickSight 资源。

标签可以帮助您对资源进行组织和分类。您还可以使用它们来限定用户权限的范围，方法是只授予用户访问或更改具有特定标签值的资源的权限。您可以使用TagResource对已有标签的资源执行操作。如果为资源指定了新的标签键，则此标签会附加到与资源关联的标签列表中。如果您指定的标签键已与资源关联，则您指定的新标签值将替换该标签的先前值。

您可以将多达 50 个标签与资源关联。亚马逊 QuickSight 支持对数据集、数据源、仪表板和模板进行标记。

为亚马逊加标签 QuickSight 工作方式类似于为其添加标签AWS服务，以下内容除外：

  • 您无法使用标签跟踪亚马逊的费用 QuickSight. 这是不可能的，因为您无法标记亚马逊的资源 QuickSight 成本基于，例如亚马逊 QuickSight 存储容量 (SPICE)、用户数量、用户类型和使用量指标。

  • 亚马逊 QuickSight 目前不支持的标签编辑器AWS Resource Groups.

请求语法

POST /resources/ResourceArn/tags HTTP/1.1
Content-type: application/json

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

URI 请求参数

请求使用以下 URI 参数。

ResourceArn

您要标记的资源的 Amazon 资源名称 (ARN)。

必需：是

请求正文

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

Tags

包含分配给资源的一个或多个资源标签的键值对映射。

类型: 数组Tag对象

数组成员：最少 1 项。最多 200 项。

必需：是

响应语法

HTTP/1.1 Status
Content-type: application/json

{
   "RequestId": "string"
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 响应。

Status

请求的 HTTP 状态。

服务以 JSON 格式返回的以下数据。

RequestId

这些区域有：AWS用于此操作的请求 ID。

类型: 字符串

错误

有关所有操作常见错误的信息，请参阅常见错误.

AccessDeniedException

您无权访问此项。无法验证提供的凭证。您可能无权执行请求。确保您的账户已获得使用亚马逊的授权 QuickSight 服务，您的策略具有正确的权限，并且您使用的是正确的访问密钥。

HTTP 状态代码：401

InternalFailureException

出现内部故障。

HTTP 状态代码：500

InvalidParameterValueException

一个或多个参数的值无效。

HTTP 状态代码：400

LimitExceededException

超出限制。

HTTP 状态代码：409

ResourceNotFoundException

无法找到一个或多个资源。

HTTP 状态代码：404

ThrottlingException

访问受限。

HTTP 状态代码：429

另请参阅

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：