检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
删除预定义标签 功能介绍 用于删除预定义标签。该接口支持幂等特性和处理批量数据。 调用方法 请参见如何调用API。 URI POST /v1.0/predefine_tags/action 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token
批量添加标签 功能介绍 用于给云服务的多个资源添加标签,每个资源最多可添加10个标签,每次最多支持批量操作50个资源。 调用方法 请参见如何调用API。 URI POST /v1.0/resource-tags/batch-create 请求参数 表1 请求Header参数 参数
批量移除标签 功能介绍 用于批量移除云服务多个资源的标签,每个资源最多支持移除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。 URI POST /v1.0/predefine_tags/action 请求参数 表1 请求Header
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 TMS.0002 Bad request. 请求数据非法 请检查请求参数 400 TMS.0007
返回结果 状态码 请求发送以后,您会收到响应,其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头
状态码 正常 返回值 说明 200 OK GET和PUT操作正常返回。 201 Created POST操作正常返回。 202 Accepted 请求已被接受。 204 No Content 正常返回。 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401
构造请求 本节介绍REST API请求的组成,并以调用IAM服务的管理员创建IAM用户来说明如何调用API,该API获取用户的Token,Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com
支持审计的关键操作列表 云审计服务支持的标签管理服务操作列表如表1所示。 表1 云审计服务支持的TMS操作列表 操作名称 资源类型 事件名称 创建预定义标签 predefineTag addPredefineTag 删除预定义标签 predefineTag deletePredefineTag
标签设计原则和命名示例 标签设计的原则 企业上云后,云上创建的资源不断增加,有些大型企业资源数量达到十万、百万级别,一个账号内存在大量资源,企业需要进行分类管理。单纯通过人工进行资源的分类,效率低下,操作困难,此时需要借助云上的自动化平台化能力来解决。 华为云推荐您使用标签对资源进行标记
用户权限 系统默认提供两种用户权限:用户管理权限和资源管理权限。 用户管理权限可以管理用户、用户组及其权限。 资源管理权限可以控制用户对云服务资源执行的操作。 对于资源标签的使用,您需要拥有对应云服务的相关权限。否则,您对云资源进行的标签操作可能无法生效。 请联系系统管理员为您所属的用户组添加对应云服务的相关权限
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证调用请求。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。推荐使用AK/SK认证,其安全性比Token认证要高
TMS自定义策略 如果系统预置的TMS权限,不满足您的授权要求,可以创建自定义策略。自定义策略中可以添加的授权项(Action)请参考标签管理服务API授权列表项章节。 目前云服务平台支持以下两种方式创建自定义策略: 可视化视图创建自定义策略:无需了解策略语法,按可视化视图导航栏选择云服务
标签管理服务API授权列表项 表1 TMS授权项列表 权限 对应API接口 授权项(Action) IAM项目(Project) 企业项目(Enterprise Project) 查询预定义标签 GET /v1.0/predefine_tags tms:predefineTags:
权限管理 如果您需要对华为云上购买的云资源,给企业中的员工设置不同的访问权限,以达到不同员工之间的权限隔离,您可以使用统一身份认证服务(Identity and Access Management,简称IAM)进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能,可以帮助您安全的控制华为云资源的访问
添加标签与创建标签键二者有什么不同? 添加标签时,仅设置标签“键”,则标签“值”默认为空值。在单击“确认”之后,将会有具体的标签与云资源关联。该功能支持批量操作。 创建标签键是在资源标签展示列表中添加“键”列,该“键”列下的所有“值”的默认状态为“无标签”,即默认不会有具体的标签与云资源关联
快速入门 本节通过调用TMS的API创建预定义标签。 通过IAM服务获取到的Token有效期为24小时,需要使用同一个Token鉴权时,可以先将Token缓存,避免频繁调用。 涉及API 当您使用Token认证方式完成认证鉴权时,需要获取用户Token并在调用接口时增加“X-Auth-Token
查询审计事件 操作场景 用户进入云审计服务创建管理类追踪器后,系统开始记录云服务资源的操作。在创建数据类追踪器后,系统开始记录用户对OBS桶中数据的操作。云审计服务管理控制台会保存最近7天的操作记录。 本节介绍如何在云审计服务管理控制台查看或导出最近7天的操作记录: 在新版事件列表查看审计事件