检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
可视化服务,提供跨区域、跨服务的集中标签管理和资源分类功能。 您可以使用本文档提供API创建或删除预定义标签、查询预定义标签列表、修改预定义标签等。支持的全部操作请参见API概览。 在调用标签管理服务API之前,请确保已经充分了解标签管理服务相关概念,详细信息请参见产品介绍。 标
权限管理 创建用户并授权使用TMS TMS自定义策略
图解标签管理服务
资源标签 资源标签简介 搜索云资源 创建标签键 添加资源标签 修改资源标签 删除资源标签 标签关联资源
审计 支持审计的关键操作列表 查询审计事件
预定义标签 预定义标签简介 创建预定义标签 搜索预定义标签 删除预定义标签 导入和导出预定义标签
安全 责任共担 身份认证与访问控制 审计与日志 数据保护技术
数据保护技术 静态数据保护 传输中的数据保护 数据销毁机制 父主题: 安全
通过标签实现资源快速分类及查询 场景介绍 按部门和规格为ECS添加标签 通过已设置标签快速查询资源 通过预定义标签快速标识云资源 按企业项目配置标签
删除预定义标签 功能介绍 用于删除预定义标签。该接口支持幂等特性和处理批量数据。 调用方法 请参见如何调用API。 URI POST /v1.0/predefine_tags/action 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token
查询标签键列表 功能介绍 查询指定区域的所有标签键。 调用方法 请参见如何调用API。 URI GET /v1.0/tag-keys 表1 Query参数 参数 是否必选 参数类型 描述 region_id 否 String 区域ID limit 否 Integer 查询记录数。
查询标签值列表 功能介绍 查询指定区域的标签键下的所有标签值。 调用方法 请参见如何调用API。 URI GET /v1.0/tag-values 表1 Query参数 参数 是否必选 参数类型 描述 region_id 否 String 区域ID,存在时查询该区域标签值列表 limit
创建预定义标签 功能介绍 用于创建预定义标签。用户创建预定义标签后,可以使用预定义标签来给资源创建标签。 该接口支持幂等特性和处理批量数据。 调用方法 请参见如何调用API。 URI POST /v1.0/predefine_tags/action 请求参数 表1 请求Header参数
请参见如何调用API。 URI PUT /v1.0/predefine_tags 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。说明:由于TMS是全局服务,因此调用IAM服务获取用户Token接口时需要注
查询标签管理支持的服务 功能介绍 查询标签管理支持的服务。 调用方法 请参见如何调用API。 URI GET /v1.0/tms/providers 表1 Query参数 参数 是否必选 参数类型 描述 locale 否 String 指定显示语言 limit 否 Integer
查询预定义标签列表 功能介绍 用于查询预定义标签列表。 调用方法 请参见如何调用API。 URI GET /v1.0/predefine_tags 表1 Query参数 参数 是否必选 参数类型 描述 key 否 String 键,支持模糊查询,不区分大小写,如果包含“non-U
快速入门 本节通过调用TMS的API创建预定义标签。 通过IAM服务获取到的Token有效期为24小时,需要使用同一个Token鉴权时,可以先将Token缓存,避免频繁调用。 涉及API 当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 TMS.0002 Bad request. 请求数据非法 请检查请求参数 400 TMS.0007
须具备调用该接口所需的权限,否则,API请求将调用失败。每个接口所需要的权限,与各个接口所对应的授权项相对应,只有发起请求的用户被授予授权项所对应的策略,该用户才能成功调用该接口。例如,用户要调用接口来查询预定义标签,那么这个IAM用户被授予的策略中必须包含允许“tms:pred
状态码 正常 返回值 说明 200 OK GET和PUT操作正常返回。 201 Created POST操作正常返回。 202 Accepted 请求已被接受。 204 No Content 正常返回。 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401