检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
预定义标签操作 创建预定义标签 删除预定义标签 查询预定义标签列表 修改预定义标签 父主题: API说明
查询标签管理支持的服务 查询标签管理支持的服务 父主题: API说明
资源标签 批量添加标签 批量移除标签 查询标签键列表 查询标签值列表 查询资源标签 根据标签过滤资源 父主题: API说明
如何调用API 构造请求 认证鉴权 返回结果
API说明 查询版本操作 预定义标签操作 配额 查询标签管理支持的服务 资源标签
修订记录 版本日期 变更说明 2023-07-10 第六次正式发布。 新增标签支持的资源类型章节。 2022-12-09 第五次正式发布。 新增资源标签相关接口。 新增查询标签管理支持的服务接口。 2021-11-30 第四次正式发布。 新增查询标签配额接口。 2018-09-30
权限策略与授权项 策略及授权项说明 标签管理服务API授权列表项
图解标签管理服务
资源标签 资源标签简介 搜索云资源 创建标签键 添加资源标签 修改资源标签 删除资源标签 标签关联资源
审计 支持审计的关键操作列表 查询审计事件
预定义标签 预定义标签简介 创建预定义标签 搜索预定义标签 删除预定义标签 导入和导出预定义标签
配额 查询标签配额 父主题: API说明
附录 状态码 错误码 获取项目ID
API方式 如果用户需要将公有云平台上的标签管理服务集成到第三方系统,用于二次开发,请使用API方式访问标签管理服务。具体操作请参见《标签管理服务API参考》。 管理控制台方式 管理控制台是网页形式的,您可以使用直观的界面进行相应的操作。登录管理控制台,单击主页左上角的,选择“管理与监管”下的“标签管理服务”以打开本服务界面。
示例指导您在拥有大量云资源时,如何使用标签管理服务对云资源进行快速分类及查询。 某公司购买了一批华为云资源,包括弹性云服务器(ECS)、云硬盘(EVS)等,现有如下需求: 将所拥有的资源按业务部门及资源规格等类型进行划分。 需要可以快速定位到使用频率较高的华北-北京四区域、运维部下的规格类型为通用型的弹性云服务器。
标签用于标识云资源,当您拥有相同类型的许多云资源时,可以使用标签按各种维度(例如用途、所有者或环境等)对云资源进行分类。 图1 标签示例 图1说明了标签的工作方式。在此示例中,您为每个云资源分配了两个标签,每个标签都包含您定义的一个“键”和一个“值”,一个标签使用键为“所有者”,另一个使用键为“用途”,每个标签都拥有相关的值。
和私有访问密钥一起使用,对请求进行加密签名。 SK(Secret Access Key):私有访问密钥。与访问密钥ID结合使用,对请求进行加密签名,可标识发送方,并防止请求被修改。 使用AK/SK认证时,您可以基于签名算法使用AK/SK对请求进行签名,也可以使用专门的签名SDK对
标签的“值”可以根据需要设置为具体的值,也可以不输入任何内容将其留空,如不设置则此标签的“值”会显示为“空值”。后续您可以随时将其修改为具体的值,空值并不影响标签使用。
标签命名使用英文时,建议使用统一大小写的英文字母,避免大小写混杂。 标签命名使用中文时,建议尽量简洁,且键/值长度均不超过6个字符(中文字符在数据库中占位较长,避免超过上限)。 语义一致简洁 同一类资源的分类建议使用同一个标签来标识。例如:如已使用标签键purpose来标识资源的用途分类,则避免再使用use、用途等相同语义的标签。
创建预定义标签 功能介绍 用于创建预定义标签。用户创建预定义标签后,可以使用预定义标签来给资源创建标签。 该接口支持幂等特性和处理批量数据。 调用方法 详细信息请参见如何调用API。 URI POST /v1.0/predefine_tags/action 请求参数 表1 请求Header参数