检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 表1 TMS接口列表 API 说明 查询API版本列表 查询TMS的API版本列表。 查询API版本号详情 查询TMS的API版本号详情。 创建预定义标签 创建预定义标签。用户创建预定义标签后,可以使用预定义标签来给资源添加标签。 删除预定义标签 删除预定义标签。用户可以删除已创建的预定义标签
资源标签 资源标签简介 搜索云资源 创建标签键 添加资源标签 修改资源标签 删除资源标签 标签关联资源
快速入门 本节通过调用TMS的API创建预定义标签。 通过IAM服务获取到的Token有效期为24小时,需要使用同一个Token鉴权时,可以先将Token缓存,避免频繁调用。 涉及API 当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token
使用前必读 欢迎使用标签管理服务(Tag Management Service,简称TMS)。标签用于标识云资源,当您拥有相同类型的许多云资源时,可以使用标签按各种维度(例如用途、所有者或环境)对云资源进行分类。标签管理服务是一种快速便捷将标签集中管理的可视化服务,提供跨区域、跨服务的集中标签管理和资源分类功能
如何访问 公有云提供了Web化的服务管理平台,即管理控制台和基于HTTPS请求的API(Application Programming Interface)管理方式。 API方式 如果用户需要将公有云平台上的标签管理服务集成到第三方系统,用于二次开发,请使用API方式访问标签管理服务
API说明 查询版本操作 预定义标签操作 配额 查询标签管理支持的服务 资源标签
约束与限制 以下是标签使用的基本限制: 表1 标签约束与限制 限制项 规格 每个资源最多支持的键-值对数 10个 资源绑定限制 对于每个资源,每个标签“键”都必须是唯一的,每个标签“键”只能有一个“值”。 每个账号中允许创建预定义标签的最大数量 500个 创建预定义标签的限制 创建的预定义标签如果与已有的预定义标签完全相同
配额 查询标签配额 父主题: API说明
查询审计事件 操作场景 用户进入云审计服务创建管理类追踪器后,系统开始记录云服务资源的操作。在创建数据类追踪器后,系统开始记录用户对OBS桶中数据的操作。云审计服务管理控制台会保存最近7天的操作记录。 本节介绍如何在云审计服务管理控制台查看或导出最近7天的操作记录: 在新版事件列表查看审计事件
数据保护技术 静态数据保护 传输中的数据保护 数据销毁机制 父主题: 安全
使用场景 标签管理服务支持以下两种典型应用场景: 资源集中处理 对于拥有大量云资源的用户,可以通过标签管理服务,快速查找标识有某标签的所有云资源,可对这些资源标签统一进行检视、修改、删除等操作。 图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
审计与日志 云审计服务(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
搜索云资源 在添加标签时,首先需要搜索可添加标签的云资源。系统将云资源的标签信息集中显示,您可对云资源进行标签添加、删除、修改等操作。 标签管理服务为您提供以下搜索条件: 设置搜索区域。 设置搜索的资源类型。 (可选)设置搜索指定标签。 最多可同时查找10个标签。 如果需要设置搜索指定标签时
查询版本操作 查询API版本列表 查询API版本号详情 父主题: API说明
构造请求 本节介绍REST API请求的组成,并以调用IAM服务的管理员创建IAM用户来说明如何调用API,该API获取用户的Token,Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com