检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
预定义标签简介 通过预定义标签功能，您可以从业务角度提前规划并创建标签，也可以批量导入或导出标签。在使用服务资源时，可以快速将预定义标签与云资源进行关联。 本章节指导您如何查找、创建、删除及导入和导出预定义标签。 约束与限制 创建的预定义标签如果与已有的预定义标签完全相同，则会覆
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证调用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。
创建标签键 当需要为搜索结果列表中所有资源统一添加拥有同样标签“键”的标签时，您可以使用创建标签键功能。 创建完成后，此标签键将显示在标签展示列中，该“键”列下的所有“值”的默认状态为“无标签”，即默认不会有具体的标签与云资源关联。您可以根据需求在列表中为云资源添加具体的标签“值”，标签即可生效。
导入和导出预定义标签 约束与限制 预定义标签导入功能支持将第三方导出的“.csv”文件直接导入标签管理服务使用，且“.csv”文件的编码格式须为“UTF-8”。 IE9浏览器导出的标签文件或下载的模板文件，不支持在其他浏览器导入。反之，其他浏览器导出下载的文件，不支持在IE9导入。
标签设计原则和命名示例 标签设计的原则 企业上云后，云上创建的资源不断增加，有些大型企业资源数量达到十万、百万级别，一个账号内存在大量资源，企业需要进行分类管理。单纯通过人工进行资源的分类，效率低下，操作困难，此时需要借助云上的自动化平台化能力来解决。 华为云推荐您使用标签对资源
批量添加标签 功能介绍 用于给云服务的多个资源添加标签，每个资源最多可添加10个标签，每次最多支持批量操作50个资源。 调用方法 请参见如何调用API。 URI POST /v1.0/resource-tags/batch-create 请求参数 表1 请求Header参数 参数
创建预定义标签 功能介绍 用于创建预定义标签。用户创建预定义标签后，可以使用预定义标签来给资源创建标签。 该接口支持幂等特性和处理批量数据。 调用方法 详细信息请参见如何调用API。 URI POST /v1.0/predefine_tags/action 请求参数 表1 请求Header参数
修改预定义标签 功能介绍 修改预定义标签。 调用方法 详细信息请参见如何调用API。 URI PUT /v1.0/predefine_tags 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。说明：
资源标签简介 通过给账号下资源添加标签，可以对资源进行自定义标记，实现资源的分类。标签管理服务提供可视化表格操作资源标签，并支持对标签进行批量操作。 您也可以在标签管理服务控制台搜索指定区域下的全部资源标签和预定义标签，并支持为标签批量绑定多个云资源，每次操作支持批量绑定500个云资源。
查询API版本列表 功能介绍 查询标签管理服务的API版本列表。 调用方法 详细信息请参见如何调用API。 URI GET / 请求参数 无 响应参数 状态码： 200 表1 响应Body参数 参数 参数类型 描述 versions Array of VersionDetail objects
查询标签键列表 功能介绍 查询指定区域的所有标签键。 调用方法 请参见如何调用API。 URI GET /v1.0/tag-keys 表1 Query参数 参数 是否必选 参数类型 描述 region_id 否 String 区域ID limit 否 Integer 查询记录数。
约束与限制 以下是标签使用的基本限制： 表1 标签约束与限制 限制项 规格 每个资源最多支持的键-值对数 10个 资源绑定限制 对于每个资源，每个标签“键”都必须是唯一的，每个标签“键”只能有一个“值”。 每个账号中允许创建预定义标签的最大数量 500个 创建预定义标签的限制 创
为云资源添加标签 您可以通过以下两种方式为云资源添加标签： 通过TMS控制台添加标签 当您拥有一批云资源，需要统一为其添加标签时，推荐您通过TMS控制台进行操作。 通过各服务控制台添加标签 当您使用某一服务资源时，可以在对应服务控制台上为其添加标签。对于新建云资源，可以直接在配置参数时，对标签项进行配置。
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
查询API版本号详情 功能介绍 查询指定的标签管理服务API版本号详情。 调用方法 详细信息请参见如何调用API。 URI GET /{api_version} 表1 路径参数 参数 是否必选 参数类型 描述 api_version 是 String API版本号。 请求参数 表2
查询标签值列表 功能介绍 查询指定区域的标签键下的所有标签值。 调用方法 请参见如何调用API。 URI GET /v1.0/tag-values 表1 Query参数 参数 是否必选 参数类型 描述 region_id 否 String 区域ID，存在时查询该区域标签值列表 limit
标签管理服务API授权列表项 表1 TMS授权项列表 权限 对应API接口 授权项(Action) IAM项目(Project) 企业项目(Enterprise Project) 查询预定义标签 GET /v1.0/predefine_tags tms:predefineTags:list
查询标签管理支持的服务 功能介绍 查询标签管理支持的服务。 调用方法 请参见如何调用API。 URI GET /v1.0/tms/providers 表1 Query参数 参数 是否必选 参数类型 描述 locale 否 String 指定显示语言 limit 否 Integer
状态码 正常 返回值 说明 200 OK GET和PUT操作正常返回。 201 Created POST操作正常返回。 202 Accepted 请求已被接受。 204 No Content 正常返回。 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401
查询资源标签 功能介绍 查询单个资源上的标签。 调用方法 请参见如何调用API。 URI GET /v2.0/resources/{resource_id}/tags 表1 路径参数 参数 是否必选 参数类型 描述 resource_id 是 String 资源ID 表2 Query参数
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
