# 查询浏览器配置列表 - ListCoreBrowserProfiles
#### 功能介绍
该API用于查询浏览器配置列表。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。
#### 授权信息
账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。
| 授权项                                              | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| agentarts:browserProfile:listCoreBrowserProfiles | List | -           | -   | -  | -      |
   
#### URI
GET /v1/core/browser-profiles
表1Query参数 
| 参数                | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| name              | 否    | String           | **参数解释：** 按浏览器配置名称过滤。 **约束限制：** 长度范围：2到40个字符 **取值范围：** 长度在2到40之间 **默认取值：** 空                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| offset            | 否    | Integer          | **参数解释：** 分页查询的偏移量，表示从第几条记录开始查询，用于分页场景。 **约束限制：** 不涉及。 **取值范围：** 非负整数，取值范围为0-100000。 **默认取值：** 0。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| limit             | 否    | Integer          | **参数解释：** 分页查询时每页返回的记录数量，用于控制单次查询返回的数据量。 **约束限制：** 不涉及。 **取值范围：** 正整数，取值范围为1-1000。 **默认取值：** 1000。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| sort_key          | 否    | String           | **参数解释：** 排序字段。 **约束限制：** 不涉及。 **取值范围：** - created_at：按创建时间排序。    **默认取值：** created_at。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| sort_dir          | 否    | String           | **参数解释：** 排序方向。 **约束限制：** 不涉及。 **取值范围：** - asc：升序排列。   - desc：降序排列。    **默认取值：** desc。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| tag_key_exists    | 否    | Array of strings | **参数解释**： 需要匹配的包含该标签名称的资源。 **约束限制**： 支持批量查询多个标签名，数组最小数量1，最大数量10。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| tag_key_matches   | 否    | Array of strings | **参数解释**： 需要匹配的包含该标签的资源。 **约束限制**： 需要和tag_value_matches条件配合使用，tag_key_matches和tag_value_matches的元素个数需要一致，且标签顺序需要完全匹配，不支持空字符串。支持批量查询多个标签，数组最小数量1，最大数量10。tag_key_matches和tag_value_matches键值对不可重复。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| tag_value_matches | 否    | Array of strings | **参数解释**： 需要匹配的包含该标签的资源。 **约束限制**： 需要和tag_key_matches条件配合使用，tag_key_matches和tag_value_matches的元素个数需要一致，且标签顺序需要完全匹配，支持空字符串。支持批量查询多个标签，数组最小数量1，最大数量10。tag_key_matches和tag_value_matches键值对不可重复。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| tag_match_policy  | 否    | String           | **参数解释**： 标签匹配模式，仅针对tag_key_exists，tag_key_matches，tag_value_matches参数生效。 - ALL: 若请求中包含tag_key_exists参数，查询规则为资源标签需要包含tag_key_exists中的所有元素，若请求中tag_key_matches以及tag_value_matches参数存在，查询规则为资源标签需要包含所有tag_key_matches以及tag_value_matches参数中指定的key-value对应的标签。   - ANY: 若请求中包含tag_key_exists参数，查询规则为资源标签需要包含tag_key_exists中的任意一个元素，若请求中tag_key_matches以及tag_value_matches参数存在，查询规则为资源标签需要包含tag_key_matches以及tag_value_matches参数中任意一个key-value对应的标签。   - ALL   - ANY    三个参数都存在时，取tag_key_exists和tag_key_matches，tag_value_matches的交集。 三个参数都存在时，取tag_key_exists和tag_key_matches，tag_value_matches的并集。 **约束限制**： 不涉及。 **取值范围**： **默认取值**： ALL。 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数          | 参数类型                                                                                           | 描述                                                                                                                                                                      |
|:---|:---|:---|
| total_count | Integer                                                                                        | **参数解释：** 总记录数。 **取值范围：** 0到20。        |
| items       | Array of [BrowserProfileBasic] objects | **参数解释：** 查询列表数组 **取值范围：** 数组长度0到50个元素 |
   
 表3BrowserProfileBasic 
| 参数                              | 参数类型                                                                             | 描述                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| id                              | String                                                                           | **参数解释：** 浏览器配置ID。 **取值范围：** 符合UUID规则\^\[0-9a-f\]{8}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{4}-\[0-9a-f\]{12}$的36位字符串。          |
| name                            | String                                                                           | **参数解释：** 浏览器配置的名称。 **取值范围：** 符合正则\^\[a-z\]\[a-z0-9-\]{0,38}\[a-z0-9\]$，即必须以小写字母开头，小写字母或数字结尾，中间可包含数字、小写字母、中划线，字符长度必须在2-40个字符之间。 |
| description                     | String                                                                           | **参数解释：** 浏览器配置的描述。 **取值范围：** 任意字符，长度不能超过4096个字符                                                                                |
| last_saved_browser_id           | String                                                                           | **参数解释：** 最近保存的浏览器ID。 **取值范围：** 长度36到36个字符。                                                                                     |
| last_saved_browser_name         | String                                                                           | **参数解释：** 最近保存的浏览器名称。 **取值范围：** 长度1到64个字符。                                                                                      |
| last_saved_browser_session_id   | String                                                                           | **参数解释：** 最近保存的浏览器会话ID。 **取值范围：** 长度36到36个字符。                                                                                   |
| last_saved_browser_session_name | String                                                                           | **参数解释：** 最近保存的浏览器会话名称。 **取值范围：** 长度1到128个字符。                                                                                   |
| last_saved_at                   | String                                                                           | **参数解释：** 最近保存时间。 **取值范围：** ISO 8601日期时间格式字符串。                                                                                  |
| tags                            | Array of [CoreToolsTag] objects | **参数解释：** 资源标签。 **取值范围：** 数组长度0到20个元素。                                                                                          |
| created_at                      | String                                                                           | **参数解释：** 创建时间。 **取值范围：** ISO 8601日期时间格式字符串。                                                                                    |
   
 表4CoreToolsTag 
| 参数    | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|
| key   | String | **参数解释：** 标签键，不能为空且同一资源下标签键不能重复。 **取值范围：** 符合规则\^((?!\\s)(?!*sys* )\[\\p{L}\\p{Z}\\p{N}*.:/=+-@\]\*)(?\<!\\s)$，即可以包含任意语种的字母、数字和空格，以及*.:=+-@字符，但首尾不能包含空格，且不能以_sys_开头，且长度在1到128之间。 |
| value | String | **参数解释：** 标签值。 **取值范围：** 符合规则\^(\[\\p{L}\\p{Z}\\p{N}*.:/=+-@\]\*)$，即可以包含任意语种的字母、数字和空格，以及*.:/=+-@字符，且长度不能超过255个字符。                                                                |
   
**状态码：400**
表5响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **取值范围：** 满足正则\^AgentArts.0400\\d{4}$，例如AgentArts.04000404。                                                             |
| error_msg  | String | **参数解释：** 错误信息。 **取值范围：** 符合正则：\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()'"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 |
   
**状态码：401**
表6响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **取值范围：** 满足正则\^AgentArts.0400\\d{4}$，例如AgentArts.04000404。                                                             |
| error_msg  | String | **参数解释：** 错误信息。 **取值范围：** 符合正则：\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()'"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 |
   
**状态码：403**
表7响应Body参数 
| 参数                            | 参数类型                                                                                             | 描述                                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| error_code                    | String                                                                                           | **参数解释：** 错误码。 **取值范围：** 满足正则\^AgentArts.0400\\d{4}$，例如AgentArts.04000404。                                                             |
| error_msg                     | String                                                                                           | **参数解释：** 错误信息。 **取值范围：** 符合正则：\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()'"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 |
| encoded_authorization_message | String                                                                                           | **参数解释：** 编码后的授权失败信息。 **取值范围：** 长度1到4096个字符。                                                                                           |
| details                       | Array of [CoreToolsCommonError] objects | **参数解释：** 依赖的下游服务错误信息列表。 **取值范围：** 数组长度0到10个元素。                                                                                        |
   
 表8CoreToolsCommonError 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **取值范围：** 满足正则\^AgentArts.0400\\d{4}$，例如AgentArts.04000404。                                                             |
| error_msg  | String | **参数解释：** 错误信息。 **取值范围：** 符合正则：\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()'"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 |
   
**状态码：404**
表9响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **取值范围：** 满足正则\^AgentArts.0400\\d{4}$，例如AgentArts.04000404。                                                             |
| error_msg  | String | **参数解释：** 错误信息。 **取值范围：** 符合正则：\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()'"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 |
   
**状态码：409**
表10响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **取值范围：** 满足正则\^AgentArts.0400\\d{4}$，例如AgentArts.04000404。                                                             |
| error_msg  | String | **参数解释：** 错误信息。 **取值范围：** 符合正则：\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()'"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 |
   
**状态码：429**
表11响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **取值范围：** 满足正则\^AgentArts.0400\\d{4}$，例如AgentArts.04000404。                                                             |
| error_msg  | String | **参数解释：** 错误信息。 **取值范围：** 符合正则：\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()'"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 |
   
**状态码：500**
表12响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **取值范围：** 满足正则\^AgentArts.0400\\d{4}$，例如AgentArts.04000404。                                                             |
| error_msg  | String | **参数解释：** 错误信息。 **取值范围：** 符合正则：\^\[a-zA-Z0-9\\s\\u4e00-\\u9fff.,!?;:()'"-\\u3002\\uff0c\\uff01\\uff1f\\uff1b\\uff1a\\uff08\\uff09\]+$。 |
   
#### 请求示例
```
GET /v1/core/browsers?name=demo
```
#### 响应示例
**状态码：200**
OK。
```
{
  "items" : [ {
    "id" : "386ab51c-aaa0-4e7b-8c3f-60243a1e22fa",
    "name" : "asfasfasf",
    "description" : "zxvbzxb",
    "tags" : [ {
      "key" : "bbbbbbb",
      "value" : "zzzzzzzz"
    } ],
    "created_at" : "2022-11-09 16:37:24"
  } ],
  "total_count" : 1
}
```
**状态码：400**
请求参数错误。
```
{
  "error_code" : "AgentArts.04000400",
  "error_msg" : "Invalid parameter."
}
```
**状态码：401**
认证失败。
```
{
  "error_code" : "AgentArts.04000401",
  "error_msg" : "Authentication failed: invalid token."
}
```
**状态码：403**
权限不足。
```
{
  "error_code" : "AgentArts.04000403",
  "error_msg" : "Authentication failed: you have no permission of XXX",
  "encoded_authorization_message" : "eyJlcnJvciI6ICJVbmF1dGhvcml6ZWQifQ==",
  "details" : [ {
    "error_code" : "AgentArts.04000403",
    "error_msg" : "Authentication failed."
  } ]
}
```
**状态码：404**
资源不存在。
```
{
  "error_code" : "AgentArts.04000404",
  "error_msg" : "resource xxx not exist"
}
```
**状态码：409**
操作冲突。
```
{
  "error_code" : "AgentArts.04000409",
  "error_msg" : "operation conflict"
}
```
**状态码：429**
请求频率超限。
```
{
  "error_code" : "AgentArts.04000429",
  "error_msg" : "The interface has been limited."
}
```
**状态码：500**
内部系统错误。
```
{
  "error_code" : "AgentArts.04000500",
  "error_msg" : "Internal error"
}
```
#### 状态码
| 状态码 | 描述      |
|:---|:---|
| 200 | OK。     |
| 400 | 请求参数错误。 |
| 401 | 认证失败。   |
| 403 | 权限不足。   |
| 404 | 资源不存在。  |
| 409 | 操作冲突。   |
| 429 | 请求频率超限。 |
| 500 | 内部系统错误。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。
