构造请求 本节介绍REST API请求的组成,并以调用IAM服务的管理员创建IAM用户来说明如何调用API,该API获取用户的Token,Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com
返回结果 状态码 请求发送以后,您会收到响应,其中包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头
添加资源标签 通过TMS控制台您可以为单个云资源添加一个或多个标签,也可以为多个云资源批量添加一个或多个标签,具体请参见如下操作步骤。每个云资源最多支持添加10个键-值对。 单个资源添加标签 登录管理控制台。 单击页面左上角的图标,在弹出的服务列表中,选择“管理与监管 > 标签管理服务
修改资源标签 单个资源的标签修改 对单个资源进行标签修改时,只能对已含有标签的云资源进行修改,具体请参考以下操作步骤。 登录管理控制台。 单击页面左上角的图标,在弹出的服务列表中,选择“管理与监管 > 标签管理服务”,进入标签管理服务界面。 选择“资源配置标签”页签。 设置资源搜索条件
传输中的数据保护 数据传输到标签管理服务内部数据库的过程中使用加密协议。此部分用户不可配置。 调用标签管理服务接口时,标签管理服务支持HTTP和HTTPS两种传输协议,为保证数据传输的安全性,推荐您使用更加安全的HTTPS协议。 父主题: 数据保护技术
获取项目ID 操作场景 在调用接口的时候,部分URL中需要填入项目ID,所以需要获取到项目ID。有如下两种获取方式: 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https
认证鉴权 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。 Token认证:通过Token认证调用请求。 AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。推荐使用AK/SK认证,其安全性比Token认证要高
查询标签配额 功能介绍 查询标签的配额信息。 调用方法 请参见如何调用API。 URI GET /v1.0/tms/quotas 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。说明:由于TMS是全局服务
创建标签键 当需要为搜索结果列表中所有资源统一添加拥有同样标签“键”的标签时,您可以使用创建标签键功能。 创建完成后,此标签键将显示在标签展示列中,该“键”列下的所有“值”的默认状态为“无标签”,即默认不会有具体的标签与云资源关联。您可以根据需求在列表中为云资源添加具体的标签“值”
资源标签简介 通过给账号下资源添加标签,可以对资源进行自定义标记,实现资源的分类。标签管理服务提供可视化表格操作资源标签,并支持对标签进行批量操作。 您也可以在标签管理服务控制台搜索指定区域下的全部资源标签和预定义标签,并支持为标签批量绑定多个云资源,每次操作支持批量绑定500个云资源
批量移除标签 功能介绍 用于批量移除云服务多个资源的标签,每个资源最多支持移除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
预定义标签简介 通过预定义标签功能,您可以从业务角度提前规划并创建标签,也可以批量导入或导出标签。在使用服务资源时,可以快速将预定义标签与云资源进行关联。 本章节指导您如何查找、创建、删除及导入和导出预定义标签。 约束与限制 创建的预定义标签如果与已有的预定义标签完全相同,则会覆盖已有的预定义标签
支持审计的关键操作列表 云审计服务支持的标签管理服务操作列表如表1所示。 表1 云审计服务支持的TMS操作列表 操作名称 资源类型 事件名称 创建预定义标签 predefineTag addPredefineTag 删除预定义标签 predefineTag deletePredefineTag
根据标签过滤资源 功能介绍 根据标签过滤资源。 调用方法 请参见如何调用API。 URI POST /v1.0/resource-instances/filter 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户
导入和导出预定义标签 约束与限制 预定义标签导入功能支持将第三方导出的“.csv”文件直接导入标签管理服务使用,且“.csv”文件的编码格式须为“UTF-8”。 IE9浏览器导出的标签文件或下载的模板文件,不支持在其他浏览器导入。反之,其他浏览器导出下载的文件,不支持在IE9导入。
批量添加标签 功能介绍 用于给云服务的多个资源添加标签,每个资源最多可添加10个标签,每次最多支持批量操作50个资源。 调用方法 请参见如何调用API。 URI POST /v1.0/resource-tags/batch-create 请求参数 表1 请求Header参数 参数
查询API版本列表 功能介绍 查询标签管理服务的API版本列表。 调用方法 详细信息请参见如何调用API。 URI GET / 请求参数 无 响应参数 状态码: 200 表1 响应Body参数 参数 参数类型 描述 versions Array of VersionDetail objects
查询API版本号详情 功能介绍 查询指定的标签管理服务API版本号详情。 调用方法 详细信息请参见如何调用API。 URI GET /{api_version} 表1 路径参数 参数 是否必选 参数类型 描述 api_version 是 String API版本号。 请求参数 表2
创建预定义标签 功能介绍 用于创建预定义标签。用户创建预定义标签后,可以使用预定义标签来给资源创建标签。 该接口支持幂等特性和处理批量数据。 调用方法 详细信息请参见如何调用API。 URI POST /v1.0/predefine_tags/action 请求参数 表1 请求Header
您即将访问非华为云网站,请注意账号财产安全