检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 构造请求 认证鉴权 返回结果
API说明 查询版本操作 预定义标签操作 配额 资源标签 查询标签管理支持的服务
修订记录 版本日期 变更说明 2023-07-10 第六次正式发布。 新增标签支持的资源类型章节。 2022-12-09 第五次正式发布。 新增资源标签相关接口。 新增查询标签管理支持的服务接口。 2021-11-30 第四次正式发布。 新增查询标签配额接口。 2018-09-30
权限策略与授权项 策略及授权项说明 标签管理服务API授权列表项
快速入门 本节通过调用TMS的API创建预定义标签。 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。 涉及API 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token
如何访问 公有云提供了Web化的服务管理平台，即管理控制台和基于HTTPS请求的API（Application Programming Interface）管理方式。 API方式 如果用户需要将公有云平台上的标签管理服务集成到第三方系统，用于二次开发，请使用API方式访问标签管理服务
身份认证与访问控制 统一身份认证（Identity and Access Management，简称IAM）是华为云提供权限管理、访问控制和身份认证的基础服务，您可以使用IAM创建和管理用户、用户组，通过授权来允许或拒绝他们对云服务和资源的访问，通过设置安全策略提高账号和资源的安全性
约束与限制 以下是标签使用的基本限制： 表1 标签约束与限制 限制项 规格 每个资源最多支持的键-值对数 10个 资源绑定限制 对于每个资源，每个标签“键”都必须是唯一的，每个标签“键”只能有一个“值”。 每个账号中允许创建预定义标签的最大数量 500个 创建预定义标签的限制 创建的预定义标签如果与已有的预定义标签完全相同
使用场景 标签管理服务支持以下两种典型应用场景： 资源集中处理 对于拥有大量云资源的用户，可以通过标签管理服务，快速查找标识有某标签的所有云资源，可对这些资源标签统一进行检视、修改、删除等操作。 图1 资源集中处理 快速标识迁移资源 对于存在大量资源迁移需求的用户，可通过标签管理服务的预定义标签
审计与日志 云审计服务（Cloud Trace Service，CTS），是华为云安全解决方案中专业的日志审计服务，提供对各种云资源操作记录的收集、存储和查询功能，可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。 开通云审计服务后，CTS可记录标签管理服务的操作事件用于审计
SDK概述 本文介绍了TMS服务提供的SDK语言版本，列举了最新版本SDK的获取地址。 在线生成SDK代码 API Explorer能根据需要动态生成SDK代码功能，降低您使用SDK的难度，推荐使用。 SDK列表 表1提供了TMS服务支持的SDK列表，您可以在GitHub仓库查看SDK
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 TMS.0002 Bad request. 请求数据非法 请检查请求参数 400 TMS.0007
概述 欢迎使用标签管理服务（Tag Management Service，简称TMS）。标签用于标识云资源，当您拥有相同类型的许多云资源时，可以使用标签按各种维度（例如用途、所有者或环境）对云资源进行分类。标签管理服务是一种快速便捷将标签集中管理的可视化服务，提供跨区域、跨服务的集中标签管理和资源分类功能
标签关联资源 通过TMS控制台，您可以搜索指定区域的全部资源标签和预定义标签，并支持为标签批量绑定多个云资源，每次操作最多支持批量绑定500个云资源。 搜索标签 登录管理控制台。 单击页面左上角的图标，在弹出的服务列表中，选择“管理与监管 > 标签管理服务”，进入标签管理服务界面。
添加资源标签 通过TMS控制台您可以为单个云资源添加一个或多个标签，也可以为多个云资源批量添加一个或多个标签，具体请参见如下操作步骤。每个云资源最多支持添加10个键-值对。 单个资源添加标签 登录管理控制台。 单击页面左上角的图标，在弹出的服务列表中，选择“管理与监管 > 标签管理服务
修改资源标签 单个资源的标签修改 对单个资源进行标签修改时，只能对已含有标签的云资源进行修改，具体请参考以下操作步骤。 登录管理控制台。 单击页面左上角的图标，在弹出的服务列表中，选择“管理与监管 > 标签管理服务”，进入标签管理服务界面。 选择“资源配置标签”页签。 设置资源搜索条件
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https
资源标签简介 通过给账号下资源添加标签，可以对资源进行自定义标记，实现资源的分类。标签管理服务提供可视化表格操作资源标签，并支持对标签进行批量操作。 您也可以在标签管理服务控制台搜索指定区域下的全部资源标签和预定义标签，并支持为标签批量绑定多个云资源，每次操作支持批量绑定500个云资源
删除资源标签 单个资源的标签删除 当您需要对单个资源的标签进行删除时，可参考以下操作步骤。 登录管理控制台。 单击页面左上角的图标，在弹出的服务列表中，选择“管理与监管 > 标签管理服务”，进入标签管理服务界面。 选择“资源配置标签”页签。 设置资源搜索条件。 搜索云资源具体操作步骤可参见搜索云资源
调用说明 标签管理服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
