查询参数模板详情
功能介绍
查询参数模板详情,根据参数模板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审计日志,请在客服人员指导下进行修改。"
}
]
}
状态码
-
正常
200
-
异常
请参见状态码。
错误码
请参见错误码。