# 查询参数组列表 - ListVariableGroups
#### 功能介绍
查询参数组列表
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-pipeline/pipeline_03_0006.html)。
#### URI
POST /v5/{project_id}/api/pipeline/variable/group/list
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**： 项目ID，获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-pipeline/pipeline_03_0036.html)。 **约束限制**： 不涉及。 **取值范围**： 32位字符，由数字和字母组成。 **默认取值**： 不涉及。 |
   
#### 请求参数
表2请求Body参数 
| 参数     | 是否必选 | 参数类型   | 描述     |
|:---|:---|:---|:---|
| offset | 是    | Long   | 偏移量    |
| limit  | 是    | Long   | 单页条数   |
| name   | 否    | String | 名称模糊查询 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数                       | 参数类型                                                                                                | 描述                                                                                                                                                  |
|:---|:---|:---|
| pipeline_variable_groups | Array of [pipeline_variable_groups] objects | 详情列表                                                                                                                                                |
| offset                   | Integer                                                                                             | 偏移量                                                                                                                                                 |
| limit                    | Integer                                                                                             | 单页条数·                                                                                                                                               |
| total                    | Integer                                                                                             | **参数解释**： 总条目数量。 **取值范围**： 大于等于0。 |
   
 表4pipeline_variable_groups 
| 参数                | 参数类型                                                                                  | 描述     |
|:---|:---|:---|
| id                | String                                                                                | 参数组ID  |
| project_id        | String                                                                                | 项目ID   |
| domain_id         | String                                                                                | 租户ID   |
| name              | String                                                                                | 参数组名称  |
| description       | String                                                                                | 描述     |
| variables         | Array of strings                                                                      | 参数列表   |
| related_pipelines | Array of [related_pipelines] objects | 关联的流水线 |
| creator_id        | String                                                                                | 创建人ID  |
| updater_id        | String                                                                                | 更新人ID  |
| creator_name      | String                                                                                | 创建人名称  |
| updater_name      | String                                                                                | 更新人名称  |
| create_time       | Integer                                                                               | 创建时间   |
| update_time       | Integer                                                                               | 更新时间   |
   
 表5related_pipelines 
| 参数   | 参数类型   | 描述    |
|:---|:---|:---|
| id   | String | 流水线ID |
| name | String | 流水线名称 |
   
#### 请求示例
```
POST https://(endpoint)/v5/e2e18230a85d4d6ab0b56cb6d2246c18/api/pipeline/variable/group/list
{
  "offset" : 0,
  "limit" : 10,
  "name" : ""
}
```
#### 响应示例
**状态码：200**
响应体
```
{
  "pipeline_variable_groups" : [ {
    "id" : "e9b95653dd854146b9ff48d33c2d9d66",
    "project_id" : "e2e18230a85d4d6ab0b56cb6d2246c18",
    "domain_id" : "4b267c81b33648d982e5c2067e4c77b9",
    "name" : "121212",
    "description" : "",
    "variables" : [ ],
    "related_pipelines" : [ {
      "id" : "0747d5a7099e45f69dc1d099945909a9",
      "name" : "cloudtest"
    }, {
      "id" : "dc73b5ed58a64ab7a469b9480e5f6632",
      "name" : "PY3-0401-pipeline"
    } ],
    "creator_id" : "05d8ca972f114765a8984795a8aa4d41",
    "updater_id" : "05d8ca972f114765a8984795a8aa4d41",
    "creator_name" : "north-5",
    "updater_name" : "north-5",
    "create_time" : 1718957748000,
    "update_time" : 1718958969000
  } ],
  "offset" : 0,
  "limit" : 10,
  "total" : 1
}
```
#### 状态码
| 状态码 | 描述  |
|:---|:---|
| 200 | 响应体 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-pipeline/ErrorCode.html)。