# 查询应用列表 - ListRomaApp
#### 功能介绍
查询应用列表，支持条件查询，所有条件是并且的关系。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ROMA/doc?api=ListRomaApp)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-roma/roma_06_0018.html)。
#### URI
GET /v2/{project_id}/instances/{instance_id}/apps
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                  |
|:---|:---|:---|:---|
| instance_id | 是    | String | 实例ID。                               |
| project_id  | 是    | String | 项目ID，获取方式请参见API参考的"附录 \> 获取项目ID"章节。 |
   
表2Query参数 
| 参数        | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| offset    | 否    | Integer | 偏移量，大于等于0。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| limit     | 否    | Integer | 每页显示的条目数量。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| favorite  | 否    | Boolean | 查询收藏的应用。 - 未提供时，查询当前用户有权限的所有应用。   - 为true时，获取收藏的应用。   - 为false时，获取未被收藏的应用。                             |
| auth_role | 否    | String  | 获取拥有指定权限应用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| name      | 否    | String  | 应用名称，模糊匹配。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| key       | 否    | String  | 应用key，模糊匹配。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| owner     | 否    | Boolean | 查询有权限访问的应用。 - 未提供时，查询当前用户有权限的所有应用。   - 为true时，查询当前用户创建的应用。   - 为false时，查询非当前用户创建的有权限的应用，比如其它人共享的应用。    |
| user_name | 否    | String  | 从当前调用者有权限的所有应用中过滤出指定用户名有权限的应用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                       |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数    | 参数类型                                                                   | 描述      |
|:---|:---|:---|
| total | Integer                                                                | 总的应用数量。 |
| size  | Integer                                                                | 当前页的数量。 |
| apps  | Array of [ServerAppInfo] objects | 应用信息。   |
   
 表5ServerAppInfo 
| 参数                | 参数类型                                                                 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|
| id                | String                                                               | 应用ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| name              | String                                                               | 应用名称。 - 字符集：支持中文、英文字母、数字、中划线、下划线、点、空格和中英文圆括号。   - 约束：实例下唯一。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| remark            | String                                                               | 应用描述。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| roles             | Array of strings                                                     | 应用权限角色。 - read：应用下资源只读权限，至少要存在此权限，包括API调试。   - access：应用下资源的访问管理权限。   - delete：应用下资源的删除权限。   - modify：应用下资源的修改权限，包括API发布、下线。   - admin：应用和应用下资源的权限。   - 仅提供admin时，会自动应用其它所有权限。   - 未提供read时会自动应用read权限。    |
| create_time       | String                                                               | 创建时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| update_time       | String                                                               | 更新时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| created_user      | [created_user] object           | 创建用户信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| last_updated_user | [last_updated_user] object | 最后更新用户信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| owner             | Boolean                                                              | 是否是应用拥有者。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| key               | String                                                               | 应用认证访问KEY,未提供时随机生成。 - 字符集：支持中文、英文字母、数字、中划线、下划线、@号和点，以字母或中文或数字开头。   - 约束：实例下唯一。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| favorite          | Boolean                                                              | 是否收藏应用，收藏的应用会在列表里优先显示。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   
 表6created_user 
| 参数        | 参数类型   | 描述         |
|:---|:---|:---|
| user_id   | String | 创建应用的用户ID。 |
| user_name | String | 创建应用的用户名称。 |
   
 表7last_updated_user 
| 参数        | 参数类型   | 描述          |
|:---|:---|:---|
| user_id   | String | 最后修改者的用户ID。 |
| user_name | String | 最后修改者的用户名。  |
   
**状态码：403**
表8响应Body参数 
| 参数            | 参数类型   | 描述      |
|:---|:---|:---|
| error_code    | String | 错误码。    |
| error_msg     | String | 错误消息。   |
| error_details | String | 具体错误消息。 |
| request_id    | String | 请求处理ID。 |
   
#### 请求示例
无
#### 响应示例
**状态码：200**
ok
```
{
  "total" : 0,
  "size" : 0,
  "apps" : [ {
    "id" : "b2e6b145-4f3f-4a80-aa45-f4b8029f95a3",
    "name" : "AppName",
    "remark" : "example",
    "roles" : [ "admin" ],
    "create_time" : "2019-12-06T06:49:04Z",
    "update_time" : "2019-12-06T06:49:04Z",
    "created_user" : {
      "user_id" : "string",
      "user_name" : "string"
    },
    "last_updated_user" : {
      "user_id" : "string",
      "user_name" : "string"
    },
    "owner" : true,
    "key" : "TEI***8UM",
    "favorite" : true
  } ]
}
```
**状态码：403**
Forbidden
```
{
  "error_code" : "ROMA.00000101",
  "error_msg" : "error summary",
  "error_details" : "some error details here",
  "request_id" : "13760c1fe8655e61209b75665e9bef43"
}
```
#### 状态码
| 状态码 | 描述        |
|:---|:---|
| 200 | ok        |
| 403 | Forbidden |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-roma/ErrorCode.html)。