检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
快速入门 本节通过调用TMS的API创建预定义标签。 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。 涉及API 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Au
如何调用API 构造请求 认证鉴权 返回结果
使用前必读 欢迎使用标签管理服务（Tag Management Service，简称TMS）。标签用于标识云资源，当您拥有相同类型的许多云资源时，可以使用标签按各种维度（例如用途、所有者或环境）对云资源进行分类。标签管理服务是一种快速便捷将标签集中管理的可视化服务，提供跨区域、跨服务的集中标签管理和资源分类功能。
标签设计原则和命名示例 标签设计的原则 企业上云后，云上创建的资源不断增加，有些大型企业资源数量达到十万、百万级别，一个账号内存在大量资源，企业需要进行分类管理。单纯通过人工进行资源的分类，效率低下，操作困难，此时需要借助云上的自动化平台化能力来解决。 华为云推荐您使用标签对资源
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 TMS.0002 Bad request. 请求数据非法 请检查请求参数 400 TMS.0007
身份认证与访问控制 统一身份认证（Identity and Access Management，简称IAM）是华为云提供权限管理、访问控制和身份认证的基础服务，您可以使用IAM创建和管理用户、用户组，通过授权来允许或拒绝他们对云服务和资源的访问，通过设置安全策略提高账号和资源的安
数据销毁机制 客户删除数据后，为避免误删除，数据会在数据库历史表中保存。客户注销华为云账号后数据会保留7天，之后彻底删除。 父主题： 数据保护技术
返回结果 状态码 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET ht
预定义标签简介 通过预定义标签功能，您可以从业务角度提前规划并创建标签，也可以批量导入或导出标签。在使用服务资源时，可以快速将预定义标签与云资源进行关联。 本章节指导您如何查找、创建、删除及导入和导出预定义标签。 约束与限制 创建的预定义标签如果与已有的预定义标签完全相同，则会覆
支持审计的关键操作列表 云审计服务支持的标签管理服务操作列表如表1所示。 表1 云审计服务支持的TMS操作列表 操作名称 资源类型 事件名称 创建预定义标签 predefineTag addPredefineTag 删除预定义标签 predefineTag deletePredefineTag
权限策略与授权项 策略及授权项说明 标签管理服务API授权列表项
查询标签配额 功能介绍 查询标签的配额信息。 调用方法 请参见如何调用API。 URI GET /v1.0/tms/quotas 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。说明：由于TMS是全
删除预定义标签 登录管理控制台。 单击页面左上角的图标，在弹出的服务列表中，选择“管理与监管 > 标签管理服务”，进入标签管理服务界面。 单击“预定义标签”，进入预定义标签管理页面。 勾选需要删除的预定义标签。 单击预定义标签列表上方的“删除”。 在弹出的“删除标签”对话框中，单击“确定”。
搜索预定义标签 登录管理控制台。 单击页面左上角的图标，在弹出的服务列表中，选择“管理与监管 > 标签管理服务”，进入标签管理服务界面。 单击“预定义标签”，进入预定义标签管理页面。 在预定义标签筛选条件输入框中，选择需要查询预定义标签的“键”或者“值”。 预定义标签列表展示搜索结果。
传输中的数据保护 数据传输到标签管理服务内部数据库的过程中使用加密协议。此部分用户不可配置。 调用标签管理服务接口时，标签管理服务支持HTTP和HTTPS两种传输协议，为保证数据传输的安全性，推荐您使用更加安全的HTTPS协议。 父主题： 数据保护技术
批量移除标签 功能介绍 用于批量移除云服务多个资源的标签，每个资源最多支持移除10个标签，每次最多支持批量操作50个资源。 调用方法 请参见如何调用API。 URI POST /v1.0/resource-tags/batch-delete 请求参数 表1 请求Header参数 参数
查询资源标签 功能介绍 查询单个资源上的标签。 调用方法 请参见如何调用API。 URI GET /v2.0/resources/{resource_id}/tags 表1 路径参数 参数 是否必选 参数类型 描述 resource_id 是 String 资源ID 表2 Query参数
查询API版本列表 功能介绍 查询标签管理服务的API版本列表。 调用方法 请参见如何调用API。 URI GET / 请求参数 无 响应参数 状态码： 200 表1 响应Body参数 参数 参数类型 描述 versions Array of VersionDetail objects
删除预定义标签 功能介绍 用于删除预定义标签。该接口支持幂等特性和处理批量数据。 调用方法 请参见如何调用API。 URI POST /v1.0/predefine_tags/action 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
