更新时间:2026-01-07 GMT+08:00

获取参数模板详情

接口说明

获取指定参数模板的参数信息。

约束说明

该接口仅支持DDS社区版。

URI

  • URI格式

    GET https://{Endpoint}/v3/{project_id}/configurations/{config_id}

表1 路径参数

名称

参数类型

是否必选

说明

project_id

String

租户在某一Region下的Project id。请参考获取项目ID章节获取项目编号。

config_id

String

参数模板ID。

请求参数

表2 请求Header参数

名称

类型

IN

是否必选

描述

X-Auth-Token

string

header

用户Token。

响应参数

  • 参数说明
    表3 响应Body参数

    名称

    参数类型

    说明

    id

    String

    参数模板ID。

    name

    String

    参数模板名称。

    datastore_version

    String

    数据库版本。

    datastore_name

    String

    数据库类型。

    description

    String

    参数模板描述。

    created

    String

    创建时间,格式为“yyyy-MM-ddTHH:mm:ssZ”。

    其中,T指某个时间的开始;Z指时区偏移量。

    updated

    String

    更新时间,格式为“yyyy-MM-ddTHH:mm:ssZ”。

    其中,T指某个时间的开始;Z指时区偏移量。

    parameters

    Array of objects

    参数对象,用户基于默认参数模板自定义的参数配置。

    请参见表4

    表4 parameters字段数据结构说明

    名称

    参数类型

    说明

    name

    String

    参数名称。

    value

    String

    参数值。

    description

    String

    参数描述。

    type

    String

    参数类型。

    取值为“integer”,“string”,“boolean”,“float”或“list”。

    value_range

    String

    参数值范围。

    如integer取值0-1,boolean取值true/false等。

    restart_required

    Boolean

    参数是否需要重启。

    • 取值为“true”,需要重启。
    • 取值为“false”,不需要重启。

    readonly

    Boolean

    是否只读。

    • 取值为“true”,只读参数。
    • 取值为“false”,非只读参数。
  • 响应示例
    {
      "id": "07fc12a8e0e94df7a3fcf53d0b5e1605pr01",
      "name": "paramsGroup-test",
      "description": "",
      "datastore_name": "mongodb",
      "datastore_version": "4.0",
      "created": "2017-01-01T10:00:00",
      "updated": "2017-01-01T10:00:00",
      "parameters": [
        {
          "name": "cursorTimeoutMillis",
          "type": "integer",
          "value": 600000,
          "description": "设置空闲游标的超期时间,DDS将删除空闲的游标",
          "value_range": "600000-1000000",
          "restart_required": false,
          "readonly": false
        }
      ]
    }

状态码

详情请参见状态码

错误码

详情请参见错误码