调用DescribeDBClusterParameters接口查看PolarDB集群的参数。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeDBClusterParameters

系统规定参数,取值:DescribeDBClusterParameters

DBClusterId String pc-**********

集群ID。

返回数据

名称 类型 示例值 描述
DBType String MySQL

数据库类型,取值:

  • MySQL
  • PostgreSQL
  • Oracle
DBVersion String 5.6

数据库引擎版本号。

  • MySQL版本号取值范围如下:
    • 5.6
    • 5.7
    • 8.0
  • PostgreSQL版本号取值为11
  • Oracle版本号取值为11
Engine String POLARDB

引擎。

RequestId String EBEAA83D-1734-42E3-85E3-E25F6E******

请求ID。

RunningParameters Array

当前运行的参数列表。

Parameter
CheckingCode String [utf8|latin1|gbk|utf8mb4]

校验代码,参数的可选范围。

DataType String INT

参数值类型。

DefaultParameterValue String utf8

参数默认值。

ForceRestart Boolean true

是否需要重启生效:

  • False:否。
  • True:是。
IsModifiable Boolean true

是否可修改:

  • False:不可修改。
  • True:可修改。
ParameterDescription String The server's default character set.

参数描述。

ParameterName String character_set_server

参数名。

ParameterStatus String Normal

参数状态:

  • normal:正常。
  • modifying:修改中。
ParameterValue String utf8

参数值。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=DescribeDBClusterParameters
&DBClusterId=pc-**********
&<公共请求参数>

正常返回示例

XML 格式

<RunningParameters>
    <Parameter>
        <ParameterStatus>Normal</ParameterStatus>
        <DefaultParameterValue>1</DefaultParameterValue>
        <IsModifiable>true</IsModifiable>
        <DataType>INT</DataType>
        <ParameterDescription>Auto-increment columns are incremented by this</ParameterDescription>
        <ParameterValue>1</ParameterValue>
        <CheckingCode>[1-65535]</CheckingCode>
        <ForceRestart>false</ForceRestart>
        <ParameterName>auto_increment_increment</ParameterName>
    </Parameter>
    <Parameter>
        <ParameterStatus>Normal</ParameterStatus>
        <DefaultParameterValue>86400</DefaultParameterValue>
        <IsModifiable>true</IsModifiable>
        <DataType>INT</DataType>
        <ParameterDescription>The number of seconds the server waits for activity on a connection before closing it</ParameterDescription>
        <ParameterValue>86400</ParameterValue>
        <CheckingCode>[1-31536000]</CheckingCode>
        <ForceRestart>false</ForceRestart>
        <ParameterName>wait_timeout</ParameterName>
    </Parameter>
</RunningParameters>
<DBVersion>5.6</DBVersion>
<RequestId>EBEAA83D-1734-42E3-85E3-E25F6E8DF3EE</RequestId>
<DBType>MySQL</DBType>
<Engine>POLARDB</Engine>

JSON 格式

{
    "RunningParameters": {
        "Parameter": [
            {
                "ParameterStatus": "Normal",
                "DefaultParameterValue": 1,
                "IsModifiable": true,
                "DataType": "INT",
                "ParameterDescription": "Auto-increment columns are incremented by this",
                "ParameterValue": 1,
                "CheckingCode": "[1-65535]",
                "ForceRestart": false,
                "ParameterName": "auto_increment_increment"
            },
            {
                "ParameterStatus": "Normal",
                "DefaultParameterValue": 86400,
                "IsModifiable": true,
                "DataType": "INT",
                "ParameterDescription": "The number of seconds the server waits for activity on a connection before closing it",
                "ParameterValue": 86400,
                "CheckingCode": "[1-31536000]",
                "ForceRestart": false,
                "ParameterName": "wait_timeout"
            }
        ]
    },
    "DBVersion": "5.6",
	"RequestId": "EBEAA83D-1734-42E3-85E3-E25F6E******",
	"DBType": "MySQL",
	"Engine": "POLARDB"
}

错误码

访问错误中心查看更多错误码。