检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
场景介绍 本手册基于华为云标签管理服务实践所编写，通过一个企业应用示例指导您在拥有大量云资源时，如何使用标签管理服务对云资源进行快速分类及查询。 某公司购买了一批华为云资源，包括弹性云服务器（ECS）、云硬盘（EVS）等，现有如下需求： 将所拥有的资源按业务部门及资源规格等类型进行划分。
权限仅包含TMS ReadOnlyAccess），表示“TMS ReadOnlyAccess”已生效。 在“服务列表”中选择除标签管理服务外（假设当前权限仅包含TMS ReadOnlyAccess）的任一服务，若提示权限不足，表示“TMS ReadOnlyAccess”已生效。 父主题：
发布区域：全部 支持审计的关键操作列表 查看审计日志 API 标签管理服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，实现创建或删除预定义标签、查询预定义标签列表、修改预定义标签和查询版本信息的操作。
Not Acceptable 服务器生成的响应无法被客户端所接受。 407 Proxy Authentication Required 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 408 Request Timeout 请求超出了服务器的等待时间。 409 Conflict
按部门和规格为ECS添加标签 在标签管理服务控制台上，您可以为账号下所有云资源添加标签，实现云资源的自定义分类。以华北-北京四区域的15台ECS为例，需要为这15台ECS配置如表1所示的两组标签。 表1 ECS标签样例 ECS(台) 标签（键/值） 1~5 规格/计算加速型 部门/开发部
Migration Task（备份迁移任务） Online Migration Task（实时迁移任务） 裸金属服务器 BMS BMS（裸金属服务器） 弹性云服务器 ECS ECS（弹性云服务器） 对象存储服务 OBS Bucket（桶） 虚拟私有云 VPC VPC（虚拟私有云） Subnet（子网）
型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。
标签管理服务API授权列表项 表1 TMS授权项列表 权限 对应API接口 授权项(Action) IAM项目(Project) 企业项目(Enterprise Project) 查询预定义标签 GET /v1.0/predefine_tags tms:predefineTags:list
支持审计的关键操作列表 云审计服务支持的标签管理服务操作列表如表1所示。 表1 云审计服务支持的TMS操作列表 操作名称 资源类型 事件名称 创建预定义标签 predefineTag addPredefineTag 删除预定义标签 predefineTag deletePredefineTag
版本状态，为如下3种： CURRENT：表示该版本为主推版本。 SUPPORTED：表示为老版本，但是现在还继续支持。 DEPRECATED：表示为废弃版本，存在后续删除的可能。 updated String 版本发布时间，采用UTC时间表示。如v1.0发布的时间2016-12-09T00:00:00Z。
查询标签值列表 功能介绍 查询指定区域的标签键下的所有标签值。 调用方法 请参见如何调用API。 URI GET /v1.0/tag-values 表1 Query参数 参数 是否必选 参数类型 描述 region_id 否 String 区域ID，存在时查询该区域标签值列表 limit
即为用户Token。 响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 keys Array of strings 标签键列表 page_info PageInfoTagKeys object 分页信息 表4 PageInfoTagKeys 参数 参数类型
查询预定义标签列表 功能介绍 用于查询预定义标签列表。 调用方法 请参见如何调用API。 URI GET /v1.0/predefine_tags 表1 Query参数 参数 是否必选 参数类型 描述 key 否 String 键，支持模糊查询，不区分大小写，如果包含“non-U
为通用计算型的ECS。 登录管理控制台。 单击页面左上角的图标，在弹出的服务列表中，选择“管理与监管 > 标签管理服务”，进入标签管理服务界面。 选择“资源配置标签”页签。 设置资源搜索条件。 设置搜索区域为“华北-北京四”。 设置搜索的资源类型为“ECS-ECS”。 设置搜索指
在TMS控制台上为新迁移的ECS添加标签，筛选出新迁移的ECS资源后，可选择多个资源批量添加标签。 在ECS控制台上为新迁移的ECS添加标签，在每个ECS资源详情页的标签页签中依次添加标签。 在TMS或ECS服务控制台上为这批新迁入的ECS添加标签时，在标签输入框的下拉列表中可直接选择预定
单击按钮，可以自定义事件列表的展示信息。启用表格内容折行开关，可让表格内容自动折行，禁用此功能将会截断文本，默认停用此开关。 关于事件结构的关键字段详解，请参见事件结构和事件样例。 （可选）在新版事件列表页面，单击右上方的“返回旧版”按钮，可切换至旧版事件列表页面。 在旧版事件列表查看审计事件
以系统权限为例：例如您需要在TMS控制台对ECS资源进行增删标签操作，那么您除了需要具有“TMS FullAccess”系统权限外，还需要拥有“ECS FullAccess”系统权限。 以自定义策略为例：例如您需要在TMS控制台上查看ECS的资源和标签，那么您除了需要具有“tms:
标签管理服务主要有以下功能： 资源标签管理：通过给账号下资源添加标签，可以对资源进行自定义标记，实现资源的分类。标签管理服务为用户提供可视化表格操作资源标签，并支持对标签进行批量编辑。 资源标签搜索：用户可以跨服务、跨区域对资源进行按标签搜索，还可以多标签组合搜索。 预定义标签管理
Administrator：项目级服务，在同项目中勾选。 表2列出了TMS常用操作与系统权限的授权关系，您可以参照该表选择合适的系统权限。 表2 常用操作与系统权限的关系 操作 TMS FullAccess TMS ReadOnlyAccess TMS Administrator 查询资源列表 √（依赖各云服务的查询资源权限）
响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 providers Array of ProviderResponseBody objects 云服务列表 total_count Integer 当前支持的云服务总数 表4 ProviderResponseBody
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
