# 查询资源列表 - ListResources
#### 功能介绍
查询资源列表。查询时，可指定返回页号和每页的最大记录数。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/DGC/doc?api=ListResources)中调试该接口，支持自动认证鉴权。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dataartsstudio/abcd.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
- URI格式 GET /v1/{project_id}/resources
  
 
- 参数说明
  表1URI参数说明 
  | 参数名        | 是否必选 | 参数类型   | 说明                                                                                                    |
  |:---|:---|:---|:---|
  | project_id | 是    | String | 项目编号，获取方法请参见[项目ID和账号ID](https://support.huaweicloud.com/api-dataartsstudio/projectid_accountid.html)。 |
     
  表2Query参数 
  | 参数           | 是否必选 | 参数类型    | 描述                                                                          |
  |:---|:---|:---|:---|
  | limit        | 否    | Integer | 分页返回结果，指定每页最大记录数，范围\[1,100\]。 默认值：10 |
  | offset       | 否    | Integer | 分页列表的起始页，默认值为0。取值范围大于等于0。                                                   |
  | resourceName | 否    | String  | 资源名称。                                                                       |
     
  
#### 请求参数
表3请求Header参数 
| 参数名       | 是否必选 | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| workspace | 否    | String | 工作空间id。获取方法请参见[实例ID和工作空间ID](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0350.html)。 - 如果不设置该参数，默认查询default工作空间下的数据。  - 如果需要查询其他工作空间的数据，需要带上该消息头。 说明： - 多个DataArts Studio实例需要指定工作空间。  - 当工作空间里面没有default工作空间时，工作空间为必填参数，否则会报错。      |
   
#### 响应参数
表4参数说明 
| 参数名       | 是否必选 | 参数类型             | 说明      |
|:---|:---|:---|:---|
| total     | 是    | Integer          | 总的资源个数。 |
| resources | 是    | List\<Resource\> | 资源列表。   |
   
表5Resource参数说明 
| 参数名         | 是否必选 | 参数类型           | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| id          | 是    | String         | 资源ID，用户查询资源时使用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| name        | 是    | String         | 资源名称，只能包含英文字母、数字、中文字符、下划线或中划线，且长度为1-32个字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| type        | 是    | String         | 资源类型，包含： - archive  - file  - jar   |
| location    | 是    | String         | 资源文件所在OBS路径，当类型为jar时，location为主Jar包所在路径。最多256个字符。示例：obs://myBucket/test.jar                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| dependFiles | 否    | List\<String\> | 主Jar包所依赖的JAR包、properties文件。总的长度不能超过10240个字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| desc        | 否    | String         | 描述，长度不能超过255个字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| directory   | 否    | String         | 资源所在目录。 通过DataArts Studio管理控制台 \> 数据开发，左侧列表选择"配置管理 \> 资源管理"。在资源的目录树上，可以查看到当前已经创建的目录，默认在根目录/。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   
#### 请求示例
查询资源列表
```
GET /v1/b384b9e9ab9b4ee8994c8633aabc9505/resources
```
#### 响应示例
- 成功响应 HTTP状态码 200
  ```
  {
      "total":1,
      "resources":[
          {
              "id":"b384b9e9ab9b4ee8994c8633aabc9505",
              "name":"test",
              "type":"jar",
              "location":"obs://00000000dlf-test/hadoop-mapreduce-examples-2.4.1.jar",
              "dependFiles":[
                  "obs://00000000dlf-test/depend1.jar",
                  "obs://00000000dlf-test/depend2.jar"
              ],
              "desc":"test",
              "directory":"/resource"
          }
      ]
  }
  ```
  
- 失败响应 HTTP状态码 400
  ```
  {
      "error_code":"DLF.3051",
      "error_msg":"The request parameter is invalid."
  }
  ```