# 查询工作流列表-ListWorkflow
#### 功能介绍
本接口用于查询工作流列表。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
如果使用角色与策略授权，具体权限要求请参见[权限及授权项说明](https://support.huaweicloud.com/api-dwr/dwr_07_0050.html)。
#### URI
GET /v3/{project_id}/workflows
#### 请求消息样式
```
GET /v2/workflows/{graph_name_prefix}?x-workflow-start={start}&x-workflow-limit={limit}&x-workflow-prefix HTTP/1.1
Host: obs.cn-north-4.myhuaweicloud.com 
Authorization: authorization
Content-Type: application/json
Content-Length: length
Date: date
```
#### 请求消息参数
表1请求消息参数 
| 名称                | 是否必选 | 参数类型   | 说明           | 约束                                           |
|:---|:---|:---|:---|:---|
| graph_name_prefix | 否    | String | 工作流的名称前缀。    | 名称必须以字母或数字开头，只能由字母、数字、下划线和中划线组成，长度小于等于64个字符。 |
| x-workflow-prefix | 是    | String | 按前缀查询工作流。    | 不需要传值。                                       |
| x-workflow-start  | 否    | Int    | 查询的起始位置。     | start大于等于1，最大1000，不设置则取默认值1。                 |
| x-workflow-limit  | 否    | Int    | 请求返回的最大记录条数。 | limit取值最小1，最大1000，不设置则取默认值10。                |
   
#### 请求消息头
该请求使用公共消息头，具体参见[表3](https://support.huaweicloud.com/api-dwr/dwr_07_0008.html#dwr_07_0008__zh-cn_topic_0121682347_table1986821153312)。
#### 请求消息元素
该请求消息中不使用消息参数。
#### 响应消息样式
```
HTTP/1.1 status_code 
Date: date 
Content-Length: length 
X-Request-ID: obs request id
json body
```
#### 响应消息头
该请求的响应消息使用公共消息头，具体请参考[响应消息头](https://support.huaweicloud.com/api-dwr/dwr_07_0011.html#dwr_07_0011__zh-cn_topic_0170155703_zh-cn_topic_0113746487_section61333484715)。
#### 响应消息元素
| 名称           | 参数类型                                                                      | 说明                                                                    |
|:---|:---|:---|
| count        | Int                                                                       | 列表条数。                                                                 |
| graphs       | Array [GraphItem] | 工作流模板列表信息。                                                            |
| next_start   | Int                                                                       | 下一次查询的起始位置。                                                           |
| is_truncated | Boolean                                                                   | 表明是否本次返回的ListWorkflow结果列表被截断。"true"表示本次没有返回全部结果；"false"表示本次已经返回了全部结果。 |
   
 表2GraphItem结构体说明 
| 名称         | 参数类型   | 说明               |
|:---|:---|:---|
| name       | String | 工作流的名称。          |
| created_at | String | 系统记录的创建工作流模板的时间。 |
| graph_urn  | String | 工作流的URN。         |
   
#### 错误响应消息
无特殊错误，所有错误已经包含在[错误码](https://support.huaweicloud.com/api-dwr/ErrorCode_0.html)中。
#### 请求示例
```
GET /v2/workflows/{graph_name_prefix}?x-workflow-start={start}&x-workflow-limit={limit}&x-workflow-prefix HTTP/1.1
Host: obs.cn-north-4.myhuaweicloud.com 
Date: Thu, 27 Aug 2020 12:38:10 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:sc2PM13Wlfcoc/YZLK0MwsI2Zpo=
Content-Type: application/json
Content-Length: 0
```
#### 响应示例
```
HTTP/1.1 200 OK 
Date: Thu, 27 Aug 2020 12:38:10 GMT
Content-Length: 100
Content-Type: application/json
X-Request-ID: 6a63a18b8bab40ffb71ebd9cb80d0085
{
    "count": 1,
    "is_truncated": true,
    "next_start": 3,
    "graphs": [{
        "name": "<graph_name>",
        "create_at": "2020-04-23T12:32:11.131Z",
        "graph_urn": "urn:fgs:<region_id>:<project_id>:graph:<graph_name>"
    }]
}
```