文档首页/ 云数据库 GaussDB/ API参考/ API（推荐）/ 参数配置/ 查询参数模板详情
更新时间：2024-08-20 GMT+08:00
查看PDF
分享

查询参数模板详情

功能介绍

查询参数模板详情，根据参数模板ID获取指定参数模板详情。

调试

您可以在API Explorer中调试该接口。

URI

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

表1 参数说明

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

租户在某一Region下的项目ID。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

config_id

是

String

参数模板ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取。

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

X-Language

否

String

语言。

缺省值：en-us

枚举值：

  • zh-cn
  • en-us

响应参数

表3 参数说明

参数

参数类型

描述

id

String

参数模板ID。

name

String

参数模板名称。

description

String

参数模板描述。

engine_version

String

引擎版本。

instance_mode

String

部署形态。

枚举值：

  • ha：主备版
  • independent：独立部署

created_at

String

创建时间，格式为“yyyy-mm-ddThh:mm:ssZ”。

其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。

updated_at

String

修改时间，格式为“yyyy-mm-ddThh:mm:ssZ”。

其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。

configuration_parameters

Array of objects

参数详情，具体请参考 表configuration_parameters字段数据结构说明。
表4 configuration_parameters字段数据结构说明

参数

参数类型

描述

name

String

特定参数名称。

value

String

特定参数值。

need_restart

Boolean

参数是否需要重启。

- 取值为"true"，需要重启。

- 取值为"false"，不需要重启。

readonly

Boolean

该参数是否只读。

true：只读

false：可编辑

value_range

String

参数取值范围。

data_type

String

参数类型，取值为“string”、“integer”、“boolean”、“list”、"all"或“float”之一。

description

String

参数描述。

请求示例

查询参数模板详情。

GET https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/configurations/3ca44134a16d4bbab8eb701e025b19f7pr14

响应示例

查询参数模板详情成功。

{
         "id": "3ca44134a16d4bbab8eb701e025b19f7pr14",
         "name": "GaussDB_2b87a799-515",
         "description": "ParamGroup for instance.",
          "engine_version": "2.3",
          "instance_mode": "ha",
          "created_at": "2022-08-05T08:15:07+0800",
          "updated_at": "2022-08-09T03:06:52+0800",
          "configuration_parameters": [
                {
                     "name": "audit_system_object",
                     "value": "12294",
                     "need_restart": false,
                     "readonly": false,
                     "value_range": "1-65536",
                     "data_type": "integer",
                     "description": "该参数决定是否对GaussDB Kernel数据库对象的CREATE、DROP、ALTER操作进行审计。GaussDB Kernel数据库对象包括DATABASE、USER、schema、TABLE等。通过修改该配置参数的值，可以只审计需要的数据库对象的操作，在主备强制选主场景建议audit_system_object取最大值，所有DDL对象全部审计，不当修改该参数会导致丢失DDL审计日志，请在客服人员指导下进行修改。"
                  }
           ]
}

状态码

错误码

请参见错误码。

父主题： 参数配置

相关文档