更新时间:2024-08-20 GMT+08:00

获取指定实例的参数

功能介绍

获取指定实例的参数模板。

URI

GET https://{Endpoint}/v3.1/{project_id}/instances/{instance_id}/configurations

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

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

约束限制:

不涉及。

取值范围:

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

默认取值

不涉及。

instance_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 参数说明

参数

参数类型

描述

datastore_version

String

引擎版本。

datastore_name

String

引擎名称。

created

String

创建时间,格式为"yyyy-MM-dd HH:mm:ss"。

updated

String

更新时间,格式为"yyyy-MM-ddHH:mm:ss"。

configuration_parameters

Array of objects

参数对象,用户基于默认参数模板自定义的参数配置,具体请参考表4

表4 configuration_parameters字段数据结构说明

参数

参数类型

描述

name

String

参数名称。

value

String

参数值。

restart_required

Boolean

修改该参数是否需要重启实例。

value_range

String

参数取值范围。

type

String

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

枚举值:

  • string
  • integer
  • boolean
  • list
  • float

description

String

参数描述。

请求示例

获取指定实例的参数。

GET https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in14/configurations

响应示例

获取指定实例的参数成功。
{
    "created": "2022-04-11 10:46:59",
    "updated": "2022-04-11 10:46:59",
    "datastore_version": "2.0",
    "datastore_name": "GaussDB",
    "configuration_parameters": [
        {
            "name": "audit_system_object",
            "value": "12295",
            "type": "integer",
            "description": "Determines whether to audit the CREATE, DROP, and ALTER operations on GaussDB Kernel database objects. GaussDB Kernel database objects include databases, users, schemas, and tables. You can change the parameter value to audit only the operations on required database objects. During a forcible primary/standby failover, set audit_system_object to the maximum value and audit all DDL objects. If the parameter value is incorrectly changed, DDL audit logs will be lost. Contact customer service personnel to change it.",
            "restart_required": false,
            "value_range": "0-2097151"
        }
    ]
}

状态码

错误码

请参见错误码