# 查询配置列表 - QueryConfigurationList #### 功能介绍 从配置管理中心查询配置列表信息。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cse/cse_06_0081.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | cse:namespace:get | read | engine | - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) | - | - | #### URI GET /v1/{project_id}/kie/kv 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 请填固定值：default。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | Authorization | 否 | String | 若ServiceComb引擎专享版开启了安全认证，此参数必填。否则，无此参数。 开启了安全认证的ServiceComb引擎专享版Token，格式为： ``` Authorization:Bearer {Token} ``` Token获取方法，请参考[获取ServiceComb引擎专享版用户Token](https://support.huaweicloud.com/api-cse/cse_06_0035.html)。 | | X-Authorization | 否 | String | 若ServiceComb引擎专享版开启了安全认证，此参数必填。否则，无此参数。 开启了安全认证的ServiceComb引擎专享版Token，格式为： ``` X-Authorization:Bearer {Token} ``` Token获取方法，请参考[获取ServiceComb引擎专享版用户Token](https://support.huaweicloud.com/api-cse/cse_06_0035.html)。 | 表3Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | label | 否 | String | 按label过滤项导出，格式为：{标签key}:{标签value}。 | | match | 否 | String | 对label过滤项的匹配选项，如果值为exact，表示严格匹配，包括label个数和内容相等；不填表示包含匹配。 | | revision | 否 | Integer | 配置的版本号。 用于判断本地缓存配置和配置管理中心的配置差异。 - 首次传值0。 - 若传入的revision值与当前配置的revision一致，则返回304状态码，无body体返回；若不一致，则返回当前配置和revision信息。 - 下次请求若需要传入revision，则该值为当前返回body体中的update_revision 。 | #### 响应参数 **状态码： 200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | 查询结果个数。 | | data | List\<[SingleKieInfo]\> | 查询的kie列表。 | 表5SingleKieInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 配置id。 | | key | String | 配置的key。 | | value | String | 配置的value。 | | value_type | String | 配置value的类型。 **取值范围：** - text - yaml - json - properties - ini - xml | | status | String | 配置的状态。 **取值范围：** - enabled：配置可用。 - disabled：配置不可用。 | | create_time | String | 配置的创建时间。 | | update_time | String | 配置的更新时间。 | | labels | Map\ | 配置的标签信息。 | | create_revision | Integer | 配置的创建版本号。 | | update_revision | Integer | 配置的修改版本号。 | **状态码：304** 无 **状态码： 400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误代码。 | | error_message | String | 错误信息。 | **状态码： 500** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误代码。 | | error_message | String | 错误信息。 | #### 请求示例 查询配置列表。 ``` GET https://{endpoint}/v1/{project_id}/kie/kv ``` #### 响应示例 **状态码： 200** 查询成功。 ``` { "total": 1, "data":[{ "id": "8a9e6a5d-8d65-48fb-a40c-5150c8479da8", "key": "string", "labels": { "key1": "value1", "key2": "value2" }, "value": "string", "value_type": "text", "status": "enabled", "create_time": 1623139038, "update_time": 1623139038, "create_revision": 13, "update_revision": 13 }] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询成功。 | | 304 | 查询的配置未改变。 | | 400 | 错误的请求。 | | 500 | 服务内部错误。 | #### 错误码 请参见[ServiceComb错误码](https://support.huaweicloud.com/api-cse/cse_06_0110.html)。