检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
快速入门 本节通过调用TMS的API创建预定义标签。 通过IAM服务获取到的Token有效期为24小时,需要使用同一个Token鉴权时,可以先将Token缓存,避免频繁调用。 涉及API 当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token
如何访问 公有云提供了Web化的服务管理平台,即管理控制台和基于HTTPS请求的API(Application Programming Interface)管理方式。 API方式 如果用户需要将公有云平台上的标签管理服务集成到第三方系统,用于二次开发,请使用API方式访问标签管理服务
API说明 查询版本操作 预定义标签操作 配额 资源标签 查询标签管理支持的服务
用户权限 系统默认提供两种用户权限:用户管理权限和资源管理权限。 用户管理权限可以管理用户、用户组及其权限。 资源管理权限可以控制用户对云服务资源执行的操作。 对于资源标签的使用,您需要拥有对应云服务的相关权限。否则,您对云资源进行的标签操作可能无法生效。 请联系系统管理员为您所属的用户组添加对应云服务的相关权限
API概览 表1 TMS接口列表 API 说明 查询API版本列表 查询TMS的API版本列表。 查询API版本号详情 查询TMS的API版本号详情。 创建预定义标签 创建预定义标签。用户创建预定义标签后,可以使用预定义标签来给资源添加标签。 删除预定义标签 删除预定义标签。用户可以删除已创建的预定义标签
约束与限制 以下是标签使用的基本限制: 表1 标签约束与限制 限制项 规格 每个资源最多支持的键-值对数 10个 资源绑定限制 对于每个资源,每个标签“键”都必须是唯一的,每个标签“键”只能有一个“值”。 每个账号中允许创建预定义标签的最大数量 500个 创建预定义标签的限制 创建的预定义标签如果与已有的预定义标签完全相同
配额 查询标签配额 父主题: API说明
使用场景 标签管理服务支持以下两种典型应用场景: 资源集中处理 对于拥有大量云资源的用户,可以通过标签管理服务,快速查找标识有某标签的所有云资源,可对这些资源标签统一进行检视、修改、删除等操作。 图1 资源集中处理 快速标识迁移资源 对于存在大量资源迁移需求的用户,可通过标签管理服务的预定义标签
修订记录 版本日期 变更说明 2023-07-10 第六次正式发布。 新增标签支持的资源类型章节。 2022-12-09 第五次正式发布。 新增资源标签相关接口。 新增查询标签管理支持的服务接口。 2021-11-30 第四次正式发布。 新增查询标签配额接口。 2018-09-30
状态码 正常 返回值 说明 200 OK GET和PUT操作正常返回。 201 Created POST操作正常返回。 202 Accepted 请求已被接受。 204 No Content 正常返回。 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401
与其他服务的关系 支持标签集中管理的服务 标签管理服务规划对云资源中的所有标签进行统一集中管理,当前支持的服务如表1所示。 一个云服务可以包含多种资源类型,您可以在标签管理服务控制台根据需求选择对应的资源类型,对该类型资源的标签进行集中管理。 表1 标签管理当前支持的其他服务 服务
使用前必读 欢迎使用标签管理服务(Tag Management Service,简称TMS)。标签用于标识云资源,当您拥有相同类型的许多云资源时,可以使用标签按各种维度(例如用途、所有者或环境)对云资源进行分类。标签管理服务是一种快速便捷将标签集中管理的可视化服务,提供跨区域、跨服务的集中标签管理和资源分类功能
审计与日志 云审计服务(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
责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的云安全挑战和无孔不入的云安全威胁与攻击,华为云在遵从法律法规业界标准的基础上,以安全生态圈为护城河,依托华为独有的软硬件优势,构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任
资源标签 批量添加标签 批量移除标签 查询标签键列表 查询标签值列表 查询资源标签 根据标签过滤资源 父主题: API说明
如何调用API 构造请求 认证鉴权 返回结果
搜索预定义标签 登录管理控制台。 单击页面左上角的图标,在弹出的服务列表中,选择“管理与监管 > 标签管理服务”,进入标签管理服务界面。 单击“预定义标签”,进入预定义标签管理页面。 在预定义标签筛选条件输入框中,选择需要查询预定义标签的“键”或者“值”。 预定义标签列表展示搜索结果