# 查询全局变量分组列表 - ListVarGroupList #### 功能介绍 根据工程唯一标识查询全局变量分组列表 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI GET /v1/variables/getVarGroupList 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | page_no | 是 | String | 当前页数 | | page_size | 是 | String | 每页多少记录 | | project_id | 是 | String | **参数解释** 工程唯一标识 **约束限制** 不涉及 **取值范围** 32个字符组成的字符串 **默认取值** 不涉及 **获取方法** 进入项目，地址栏获取project_id | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 必传。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释** 接口调用失败错误码 **取值范围** 不超过256个字符组成的字符串 | | error | [CommonResponseErrorPageResultVariableGroup] object | **参数解释** 统一错误返回 **取值范围** 不涉及 | | reason | String | **参数解释** 接口调用失败原因 **取值范围** 不超过1000个字符组成的字符串 | | result | [PageResultVariableGroup] object | **参数解释** 响应结果 **取值范围** 不涉及 | | status | String | **参数解释** '状态值，如success、error' **取值范围** - success，请求成功 - error，请求报错 | 表4CommonResponseErrorPageResultVariableGroup | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | String | **参数解释** 接口调用失败错误码 **取值范围** 不超过256个字符组成的字符串 | | detail | [PageResultVariableGroup] object | **参数解释** 错误信息详情 **取值范围** 不涉及 | | reason | String | **参数解释** 接口调用失败原因 **取值范围** 不超过1000个字符组成的字符串 | 表5PageResultVariableGroup | 参数 | 参数类型 | 描述 | |:---|:---|:---| | page_list | Array of [VariableGroup] objects | **参数解释** 当前页数据 **取值范围** 不涉及 | | page_no | Integer | **参数解释** 当前页数 **取值范围** 0-999999999 | | page_size | Integer | **参数解释** 每页条数 **取值范围** 0-100 | | total_page | Integer | **参数解释** 总页数 **取值范围** 0-999999999 | | total_size | Long | **参数解释** 总条数 **取值范围** 0-999999999 | 表6VariableGroup | 参数 | 参数类型 | 描述 | |:---|:---|:---| | create_time | String | **参数解释** 创建时间(格式：yyyy-MM-dd HH:mm:ss) **取值范围** 不涉及 | | create_user | String | **参数解释** 创建者 **取值范围** 不超过255个字符组成的字符串 | | description | String | 描述 | | id | String | **参数解释** 唯一标识 **取值范围** 32个字符组成的字符串 | | isDefault | String | **参数解释** 是否是默认 **取值范围** - 1,默认 - 0,非默认 | | name | String | **参数解释** 名称 **取值范围** 不超过300个字符组成的字符串 | | projectId | String | **参数解释** 项目唯一标识 **取值范围** 32个字符组成的字符串 | | region | String | **参数解释** 区域名称 **取值范围** 不超过32个字符组成的字符串 | | update_time | String | **参数解释** 更新时间(格式：yyyy-MM-dd HH:mm:ss) **取值范围** 不涉及 | | update_user | String | **参数解释** 更新者 **取值范围** 不超过32个字符组成的字符串 | | variableList | Array of [Variable] objects | **参数解释** 融合变量 **取值范围** 不涉及 | 表7Variable | 参数 | 参数类型 | 描述 | |:---|:---|:---| | by_order | Integer | **参数解释** 顺序 **取值范围** 0-9999 | | category | String | **参数解释** 节点顺序 **取值范围** 自然数 | | create_time | String | **参数解释** 创建时间(格式：yyyy-MM-dd HH:mm:ss) **取值范围** 不涉及 | | create_user | String | **参数解释** 创建者 **取值范围** 不超过255个字符组成的字符串 | | currentPermission | String | **参数解释** 当前用户权限 **取值范围** 不涉及 | | description | String | 描述 | | dynamicParamFlag | Boolean | **参数解释** 动态参数标志,默认为false:true代表动态参数；false代表非动态参数 - true,代表动态参数 - false,代表非动态参数 | | functionParams | String | **参数解释** 变量参数（\[\]:空参、\[a\]:一参，\[a,b\]:两参） **取值范围** 不涉及 | | groupId | String | **参数解释** 环境参数分组唯一标识 **取值范围** 32个字符组成的字符串 | | id | String | **参数解释** 唯一标识 **取值范围** 32个字符组成的字符串 | | isSensitiveInfo | Boolean | **参数解释** 是否是敏感字段 **取值范围** - true, - false | | isSensitiveModified | Boolean | **参数解释** 敏感字段是否被修改，不敏感字段不关注此值 **取值范围** - true, - false | | locked | Integer | **参数解释** 是否上锁 上锁以后的全局变量进行工程复制时不会被覆盖 - 0,未上锁 - 1,上锁 | | name | String | **参数解释** 名称 **取值范围** 不超过300个字符组成的字符串 | | node_id | String | **参数解释** 节点唯一标识 **取值范围** 32个字符组成的字符串 | | node_type | Integer | **参数解释** 节点类型 **取值范围** - 0,变量节点 - null,变量节点 - 1,目录节点 | | parent_id | String | **参数解释** 关键字目录父编号 **取值范围** 32个字符组成的字符串 | | parent_node_id | String | **参数解释** 父节点唯一标识 **取值范围** 32个字符组成的字符串 | | property | String | **参数解释** 属性 **取值范围** 不涉及 | | region | String | **参数解释** 区域名称 **取值范围** 不超过32个字符组成的字符串 | | sensitiveInfoSetterTime | String | **参数解释** 敏感参数设置时间 **取值范围** 不涉及 | | sensitiveInfoSetterUser | String | **参数解释** 敏感参数设置者名称 **取值范围** 不涉及 | | sourceId | String | 复制的全局变量的源唯一标识 | | type | String | 变量类型 - String - boolean - int - Integer - integer - float - short - double - long - BigDecimal - Object - ObjectNode - ArrayNode - file,file不是java的File类型，实际是String类型，传的文件路径 - List\[/topic/body/section/table/tgroup/tbody/row/entry/ul/li/p/br {""}) (br\] - Json - JsonNode | | update_time | String | **参数解释** 更新时间(格式：yyyy-MM-dd HH:mm:ss) **取值范围** 不涉及 | | update_user | String | **参数解释** 更新者 **取值范围** 不超过32个字符组成的字符串 | | variableType | Integer | **参数解释** 变量类型（0：text，10-16：分别对应7个内置函数） **取值范围** - 10,任意长度随机字符串 - 11,指定范围随机int - 12,生成当前整数时间戳（从1970-01-01 00:00 UTC开始的秒数) - 13,按照指定的format格式化时间戳，如 $timestamp_format(timestamp, YYYY-MM-DD) - 14,生成UUID - 15,使用Base64方法编码参数 - 16,使用指定参数生成MD5哈希值 - 18,sha512编码参数 | **状态码：401** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 12-18个字符组成的字符串 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 3-1000个字符组成的字符串 | **状态码：403** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 12-18个字符组成的字符串 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 3-1000个字符组成的字符串 | **状态码：404** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 12-18个字符组成的字符串 | | error_msg | String | **参数解释** 接口调用失败错误信息 **取值范围** 3-1000个字符组成的字符串 | #### 请求示例 ``` get https://{endpoint}/v1/variables/getVarGroupList?page_no=1&page_size=10&project_id=e0c6f8fb503f413b84bb0f83417b33ff ``` #### 响应示例 **状态码：200** OK ``` { "status" : "success", "result" : { "page_no" : 1, "page_size" : 10, "total_page" : 1, "total_size" : 3, "page_list" : [ { "id" : "60f26fac760344d6b8e9f057c239ef12", "name" : "Default Environment", "projectId" : "e0c6f8fb503f413b84bb0f83417b33ff", "description" : null, "isDefault" : "1", "variableList" : null, "region" : null, "create_user" : "fdc93bccd8d040778701d4d35a4a4313", "create_time" : "2025-06-12T07:39:19+0800", "update_user" : "fdc93bccd8d040778701d4d35a4a4313", "update_time" : "2025-06-12T07:39:19+0800" }, { "id" : "122e8df96ffc4be99ddcc25436359394", "name" : "envName_LslZqrpy", "projectId" : "e0c6f8fb503f413b84bb0f83417b33ff", "description" : "", "isDefault" : "0", "variableList" : null, "region" : null, "create_user" : "CloudTest-0704", "create_time" : "2025-06-12T07:50:36+0800", "update_user" : "CloudTest-0704", "update_time" : "2025-06-12T07:50:36+0800" }, { "id" : "9172d0bf2ae44a699c36855a35e05e3f", "name" : "envName_SZ7N0ba0", "projectId" : "e0c6f8fb503f413b84bb0f83417b33ff", "description" : "", "isDefault" : "0", "variableList" : null, "region" : null, "create_user" : "CloudTest-0704", "create_time" : "2025-06-12T07:50:36+0800", "update_user" : "", "update_time" : "2025-06-12T07:50:36+0800" } ] }, "reason" : null, "error" : null } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 401 | Unauthorized | | 403 | Forbidden | | 404 | Not Found | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。