# 查询工单列表
#### 功能介绍
查询已提交的华为云工单列表。
#### URI
GET /v1.0/servicerequest/case
#### 请求消息
**请求参数**
表1参数说明 
| 参数              | 是否必选 | 参数类型    | 取值范围 | 描述                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|:---|
| searchKey       | 否    | String  | 16   | 工单简要描述模糊查询。                                                                                                                                                                                                                                      |
| caseId          | 否    | String  | 32   | 工单编号模糊查询。                                                                                                                                                                                                                                        |
| subCustomerName | 否    | String  | 32   | IAM用户名模糊查询。                                                                                                                                                                                                                                      |
| startTime       | 否    | String  | N/A  | 查询工单开始时间。 时间格式例如：2019-05-22 03:30:52                                                                                                                                                                               |
| endTime         | 否    | String  | N/A  | 查询工单结束时间。 时间格式例如：2019-05-22 03:30:52                                                                                                                                                                               |
| status          | 否    | Integer | N/A  | 状态 0：待受理 1：处理中 2：待确认结果 3：已完成 4：已撤销 查询全部传空 |
| pageNo          | 否    | Integer | N/A  | 当前页，不传默认为1。                                                                                                                                                                                                                                      |
| pageSize        | 否    | Integer | N/A  | 每页数量，取值范围：1-100，不传默认为10。                                                                                                                                                                                                                         |
   
**请求示例**
```
searchKey=华为云&caseId=&startTime=&endTime=&subCustomerId=test&status=&pageNo=1&pageSize=10
```
#### 响应消息
**响应参数**
表2响应参数 
| 参数         | 参数类型         | 描述                                                                                |
|:---|:---|:---|
| totalCount | Integer      | 工单总数。                                                                             |
| caseList   | List\<Case\> | 工单信息列表。 具体请参见[表3] |
   
 表3caseList字段数据结构说明 
| 参数               | 参数类型      | 描述                                                                                                                                                                                                                            |
|:---|:---|:---|
| caseId           | String    | 工单Id                                                                                                                                                                                                                          |
| businessTypeName | String    | 问题类型名称                                                                                                                                                                                                                        |
| typeName         | String    | 类型名称                                                                                                                                                                                                                          |
| customerId       | String    | 帐号ID                                                                                                                                                                                                                          |
| subCustomerId    | String    | IAM用户ID                                                                                                                                                                                                                       |
| subCustomerName  | String    | IAM用户名                                                                                                                                                                                                                        |
| dcName           | String    | 云服务区名称                                                                                                                                                                                                                        |
| simpleDescribe   | String    | 工单简要描述                                                                                                                                                                                                                        |
| status           | String    | 工单状态： 0：待受理 1：处理中 2：待确认结果 3：已完成 4：已撤销 12：无效 |
| createTime       | TimeStamp | 工单创建时间。 时间格式例如：2019-05-22T03:30:52Z                                                                                                                                                         |
   
**响应示例**
```
{
    "totalCount": 13,
    "caseList": [
        {
            "caseId": "TT201801020526",
            "businessTypeName": "远程登录",
            "typeName": "报障",
            "customerId": "f9ae1952bf75xxx1a0099d93ba9dd91f",
            "subCustomerId": "3dc0ca7ffd3xxx26a40f5cfa1a0da7f0",
            "subCustomerName": "xxx",
            "dcName": "华北-北京一",
            "simpleDescribe": "使用远程桌面连接windows 虚拟机，使用正常分辨率时，界面图标过小。",
            "status": 3,
            "createTime": 2019-05-22T03:30:52Z
        },
        {
            "caseId": "TT201712280631",
            "businessTypeName": "云主机创建",
            "typeName": "报障",
            "customerId": "f9ae1952bf75xxx1a0099d93ba9dd91f",
            "subCustomerId": "3dc0ca7ffd3xxx26a40f5cfa1a0da7f0",
            "subCustomerName": "xxx",
            "dcName": "华北-北京四",
            "simpleDescribe": "创建云主机失败",
            "status": 3,
            "createTime": 2019-05-22T03:30:52Z
        }
        ...
    ]
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-ticket/ticket_api_00013.html)。
#### 错误码
状态码请参见[历史错误码](https://support.huaweicloud.com/api-ticket/ticket_api_20001.html)。