
# 查询驱动文件列表 - ListUserJdbcDrivers
#### 功能介绍
查询驱动文件列表。
#### 接口约束
- 目前仅支持DB2 for LUW为源的同步场景使用。
- 仅支持部分Region使用，详情参考[终端节点](https://support.huaweicloud.com/api-drs/drs_api_0111.html)。
 
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-drs/drs_api_0035.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
GET /v5/{project_id}/drivers
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                 |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户在某一Region下的Project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-drs/drs_api_0106.html)。 |
   
表2Query参数 
| 参数          | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| limit       | 否    | Integer | 每页显示的条目数量。默认为10。                                                                                                                                                                                                                                                                                                                                          |
| offset      | 否    | Integer | 偏移量，表示从此偏移量开始查询， offset 大于等于 0。默认为0。                                                                                                                                                                                                                                                                                                                      |
| driver_type | 是    | String  | 指定待查询的驱动文件类型。取值范围： - db2：DB2 for LUW  - informix：Informix   |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| Content-Type | 是    | String | 发送的实体的MIME类型。推荐用户默认使用application/json，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。                                                                                                                                |
| X-Auth-Token | 是    | String | 从IAM服务获取的用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的"X-Subject-Token"的值即为Token值。 |
| X-Language   | 否    | String | 请求语言类型。                                                                                                                                                                                                  |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数    | 参数类型                                                                              | 描述      |
|:---|:---|:---|
| count | Integer                                                                           | 驱动文件总数。 |
| items | Array of [DriverInfo] objects | 驱动文件列表。 |
   
 表5DriverInfo 
| 参数            | 参数类型    | 描述           |
|:---|:---|:---|
| driver_name   | String  | 文件名称。        |
| last_modified | String  | 最后修改时间。      |
| size          | Integer | 文件大小，单位：byte |
   
#### 请求示例
获取驱动文件列表
```
https://{endpoint}/v5/5237e10fe9aa4ad5b16b6a5245248314/drivers?limit=10&offset=0&driver_type=db2
```
#### 响应示例
**状态码：200**
OK
```
{
  "count" : 10,
  "items" : [ {
    "driver_name" : "db2jcc_xxxxx.jar",
    "size" : 102400000,
    "last_modified" : "2020-09-01T18:50:20Z"
  } ]
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
其他状态请参见[状态码](https://support.huaweicloud.com/api-drs/drs_api_0108.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-drs/drs_05_0004.html)。
