检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
许“tms:predefineTags:list”的授权项，该接口才能调用成功。 支持的授权项 细粒度策略支持的操作与API相对应，授权项列表说明如下： 权限：允许或拒绝某项操作。 对应API接口：自定义策略实际调用的API接口。 授权项：自定义策略中支持的Action，在自定义
避免包含企业隐私信息 标签的键/值信息尽量不要使用涉及企业或个人的隐私信息，例如企业保密项目的名称、项目的收入数据、个人的电话号码和邮件地址等。 标签键设计示例 下表列举了常见业务维度的标签命名示例。涉及英文标签命名时，建议统一使用小写英文字母。 业务维度 标签键（key） 标签值（value）
响应Body参数 参数 参数类型 描述 providers Array of ProviderResponseBody objects 云服务列表 total_count Integer 当前支持的云服务总数 表4 ProviderResponseBody 参数 参数类型 描述 provider
参数类型 描述 id String 版本ID（版本号），如v1.0。 links Array of Link objects API的URL地址。 version String 若该版本API支持微版本，则返回支持的最新微版本号，如果不支持微版本，则返回空。 status String
场景介绍 本手册基于华为云标签管理服务实践所编写，通过一个企业应用示例指导您在拥有大量云资源时，如何使用标签管理服务对云资源进行快速分类及查询。 某公司购买了一批华为云资源，包括弹性云服务器（ECS）、云硬盘（EVS）等，现有如下需求： 将所拥有的资源按业务部门及资源规格等类型进行划分。
响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 quotas Array of TagQuota objects 配额列表 表3 TagQuota 参数 参数类型 描述 quota_key String 配额key quota_limit Integer 配额值
shared_bandwidth,eip, cdn等，具体请参见“查询标签管理支持的服务”章节。 tags 是 Array of Tag objects 标签列表 without_any_tag 否 Boolean 是否仅查询未带标签的资源。该字段为true时查询不带标签的资源。 offset 否 Integer
与其他服务的关系 支持标签集中管理的服务 标签管理服务规划对云资源中的所有标签进行统一集中管理，当前支持的服务如表1所示。 一个云服务可以包含多种资源类型，您可以在标签管理服务控制台根据需求选择对应的资源类型，对该类型资源的标签进行集中管理。 表1 标签管理当前支持的其他服务 服务
常用操作与系统权限的关系 操作 TMS FullAccess TMS ReadOnlyAccess TMS Administrator 查询资源列表 √（依赖各云服务的查询资源权限） √（依赖各云服务的查询资源权限） √（依赖Tenant Guest） 创建标签键 √ x √（依赖Tenant
resources 是 Array of ResourceTagBody objects 资源列表 tags 是 Array of CreateTagRequest objects 标签列表 表3 ResourceTagBody 参数 是否必选 参数类型 描述 resource_id
resources 是 Array of ResourceTagBody objects 资源列表 tags 是 Array of DeleteTagRequest objects 标签列表 表3 ResourceTagBody 参数 是否必选 参数类型 描述 resource_id
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 tags Array of TagVo objects 资源标签列表 表5 TagVo 参数 参数类型 描述 key String 键。 最大长度36个字符。 字符集：A-Z，a-z ， 0-9，‘-’，‘
操作标识（区分大小写）：delete（删除） tags 是 Array of PredefineTagRequest objects 标签列表，数量在1到50之间 表3 PredefineTagRequest 参数 是否必选 参数类型 描述 key 是 String 键。 最大长度36个字符。
操作标识（区分大小写）：create（创建） tags 是 Array of PredefineTagRequest objects 标签列表 表3 PredefineTagRequest 参数 是否必选 参数类型 描述 key 是 String 键。 最大长度36个字符。 字符集：A-Z，a-z
资源标签简介 通过给账号下资源添加标签，可以对资源进行自定义标记，实现资源的分类。标签管理服务提供可视化表格操作资源标签，并支持对标签进行批量操作。 您也可以在标签管理服务控制台搜索指定区域下的全部资源标签和预定义标签，并支持为标签批量绑定多个云资源，每次操作支持批量绑定500个云资源。
认证鉴权 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。 Token认证：通过Token认证调用请求。 AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。
什么是标签管理服务 标签管理服务（Tag Management Service，简称TMS）是一种快速便捷将标签集中管理的可视化服务，提供跨区域、跨服务的集中标签管理和资源分类功能。 标签用于标识云资源，当您拥有相同类型的许多云资源时，可以使用标签按各种维度（例如用途、所有者或环境等）对云资源进行分类。
约束与限制 以下是标签使用的基本限制： 表1 标签约束与限制 限制项 规格 每个资源最多支持的键-值对数 10个 资源绑定限制 对于每个资源，每个标签“键”都必须是唯一的，每个标签“键”只能有一个“值”。 每个账号中允许创建预定义标签的最大数量 500个 创建预定义标签的限制 创
修改预定义标签 功能介绍 修改预定义标签。 调用方法 详细信息请参见如何调用API。 URI PUT /v1.0/predefine_tags 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。说明：
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
