检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询标签值列表 功能介绍 查询指定区域的标签键下的所有标签值。 调用方法 请参见如何调用API。 URI GET /v1.0/tag-values 表1 Query参数 参数 是否必选 参数类型 描述 region_id 否 String 区域ID，存在时查询该区域标签值列表 limit
查询标签键列表 功能介绍 查询指定区域的所有标签键。 调用方法 请参见如何调用API。 URI GET /v1.0/tag-keys 表1 Query参数 参数 是否必选 参数类型 描述 region_id 否 String 区域ID limit 否 Integer 查询记录数。
创建预定义标签 功能介绍 用于创建预定义标签。用户创建预定义标签后，可以使用预定义标签来给资源创建标签。 该接口支持幂等特性和处理批量数据。 调用方法 请参见如何调用API。 URI POST /v1.0/predefine_tags/action 请求参数 表1 请求Header
查询预定义标签列表 功能介绍 用于查询预定义标签列表。 调用方法 请参见如何调用API。 URI GET /v1.0/predefine_tags 表1 Query参数 参数 是否必选 参数类型 描述 key 否 String 键，支持模糊查询，不区分大小写，如果包含“non-URL-safe
查询标签管理支持的服务 功能介绍 查询标签管理支持的服务。 调用方法 请参见如何调用API。 URI GET /v1.0/tms/providers 表1 Query参数 参数 是否必选 参数类型 描述 locale 否 String 指定显示语言 limit 否 Integer
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https
快速入门 本节通过调用TMS的API创建预定义标签。 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。 涉及API 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token
附录 状态码 错误码 获取项目ID
修订记录 版本日期 变更说明 2023-07-10 第六次正式发布。 新增标签支持的资源类型章节。 2022-12-09 第五次正式发布。 新增资源标签相关接口。 新增查询标签管理支持的服务接口。 2021-11-30 第四次正式发布。 新增查询标签配额接口。 2018-09-30
使用前必读 欢迎使用标签管理服务（Tag Management Service，简称TMS）。标签用于标识云资源，当您拥有相同类型的许多云资源时，可以使用标签按各种维度（例如用途、所有者或环境）对云资源进行分类。标签管理服务是一种快速便捷将标签集中管理的可视化服务，提供跨区域、跨服务的集中标签管理和资源分类功能
状态码 正常 返回值 说明 200 OK GET和PUT操作正常返回。 201 Created POST操作正常返回。 202 Accepted 请求已被接受。 204 No Content 正常返回。 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 TMS.0002 Bad request. 请求数据非法 请检查请求参数 400 TMS.0007
权限策略与授权项 策略及授权项说明 标签管理服务API授权列表项
传输中的数据保护 数据传输到标签管理服务内部数据库的过程中使用加密协议。此部分用户不可配置。 调用标签管理服务接口时，标签管理服务支持HTTP和HTTPS两种传输协议，为保证数据传输的安全性，推荐您使用更加安全的HTTPS协议。 父主题： 数据保护技术
支持审计的关键操作列表 云审计服务支持的标签管理服务操作列表如表1所示。 表1 云审计服务支持的TMS操作列表 操作名称 资源类型 事件名称 创建预定义标签 predefineTag addPredefineTag 删除预定义标签 predefineTag deletePredefineTag
如何访问 公有云提供了Web化的服务管理平台，即管理控制台和基于HTTPS请求的API（Application Programming Interface）管理方式。 API方式 如果用户需要将公有云平台上的标签管理服务集成到第三方系统，用于二次开发，请使用API方式访问标签管理服务
权限管理 如果您需要对华为云上购买的云资源，给企业中的员工设置不同的访问权限，以达到不同员工之间的权限隔离，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能，可以帮助您安全的控制华为云资源的访问
与其他服务的关系 支持标签集中管理的服务 标签管理服务规划对云资源中的所有标签进行统一集中管理，当前支持的服务如表1所示。 一个云服务可以包含多种资源类型，您可以在标签管理服务控制台根据需求选择对应的资源类型，对该类型资源的标签进行集中管理。 表1 标签管理当前支持的其他服务 服务
权限管理 创建用户并授权使用TMS TMS自定义策略
安全 责任共担 身份认证与访问控制 审计与日志 数据保护技术
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
