更新时间:2022-08-15 GMT+08:00

查询配置

功能业务

从配置管理中心查询配置信息。

URI

GET /v3/{project_id}/configuration/items

表1 路径参数

参数

类型

必选

说明

project_id

String

请填固定值:default。

表2 Query参数

参数

类型

必选

说明

dimensionsInfo

String

服务信息,为服务名、应用、版本的拼接(服务名、应用必填,版本选填),拼接格式为(请注意“@”和“#”添加到http url时需转义,“@”转义为“%40”,“#”转义为“%23”):

{serviceName}@{appId}#{version} 或{serviceName}@{appId}

不能包含$%^&+/\特殊字符和空格。

keyFilter

String

key的筛选条件, 支持正则表达式。涉及特殊字符的正则表达式需要自行转义。

revision

String

配置项版本。

若revision值与当前配置的revision一致,则返回304状态码,无body体返回;若不一致,则返回当前配置和revision。

请求消息

请求参数

表3 请求Header参数

参数

类型

必选

说明

x-environment

String

指定查询配置的environment,取值development|testing|acceptance|production。其他值均被作为空值处理。

响应消息

响应参数

参数说明请参见表4。(若传入的revision值与当前配置的revision一致,则无响应消息)

表4 参数说明

参数

参数类型

描述

{dimension}(参数名称和参数个数不固定)

Map<String, String>

配置内容

revision

表5

revision

表5 revision

参数

参数类型

描述

version

String

配置版本

示例

请求示例

GET /v3/default/configuration/items?dimensionsInfo=service%40app%231.0.0

响应示例

{
    "service@app": {
        "k1": "v1"
    },
    "service@app#1.0.0": {
        "k2": "v2"
    }
}

状态码

状态码请参见状态码

错误码

错误码请参见CSE错误码