调用CreateParameterGroup接口创建PolarDB参数模板。

参数模板可以批量管理集群的参数,您可以使用参数模板功能,快速应用模板到PolarDB集群上。详情请参见使用参数模板

说明 当前仅支持PolarDB MySQL集群。

调试

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

请求参数

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

系统规定参数。取值:CreateParameterGroup

RegionId String cn-hangzhou

参数模板所在地域的地域ID。

说明 您可以通过接口DescribeRegions查看地域ID。
DBType String MySQL

数据库引擎类型,当前仅支持MySQL

DBVersion String 8.0

数据库引擎版本号,取值范围如下:

  • 5.6
  • 5.7
  • 8.0
ParameterGroupName String test_group

参数模板的名称,需满足如下要求:

  • 由英文、数字、和下划线(_)组成,以字母开头,不能包含中文,不能以下划线(_)结尾。
  • 长度为8~64个字符。
ParameterGroupDesc String test_group

参数模板的描述,长度为0~199个字符。

Parameters String {"wait_timeout":"86400","innodb_old_blocks_time":"1000"}

参数及其值的JSON串,参数的值都是字符串类型,例如{"wait_timeout":"86400","innodb_old_blocks_time":"1000"}

说明 您可以通过接口DescribeParameterTemplates查看目标数据库引擎版本数据库集群的所有参数详情,包括参数名称、取值范围等。
ResourceGroupId String rg-**********

资源组ID。

返回数据

名称 类型 示例值 描述
RequestId String 514D1D87-E243-4A5F-A87D-2785C3******

请求ID。

ParameterGroupId String pcpg-**************

参数模板ID。

说明 您可以通过DescribeParameterGroups接口查看目标地域的参数模板列表,包括参数模板ID。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=CreateParameterGroup
&RegionId=cn-hangzhou
&DBType=MySQL
&DBVersion=8.0
&ParameterGroupName=test_group
&ParameterGroupDesc=test_group
&Parameters={"wait_timeout":"86400","innodb_old_blocks_time":"1000"}
&ResourceGroupId=rg-**********
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateParameterGroupResponse>
    <RequestId>514D1D87-E243-4A5F-A87D-2785C3******</RequestId>
    <ParameterGroupId>pcpg-**************</ParameterGroupId>
</CreateParameterGroupResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "514D1D87-E243-4A5F-A87D-2785C3******",
  "ParameterGroupId" : "pcpg-**************"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidRegionId.Malformed he specified parameter RegionId is not valid. 指定的参数RegionId无效
400 InvalidDBVersion.Malformed The Specified DBVersion is not valid. 指定的DBVersion无效
400 InvalidParameterGroupName.Malformed The Specified parameter ParameterGroupName is not valid. 指定的参数ParameterGroupName无效
400 NumberExceed.parameterGroupDesc The ParameterGroupDesc parameter`s number is exceed. ParameterGroupDesc参数的编号已超过
400 InvalidEngine.Unsupported The specified Engine does not support this feature. 指定的引擎不支持此功能
400 ParamGroupsNameInvalid The Specified parameter ParameterGroupName is not valid. 指定的参数ParameterGroupName无效
404 InvalidDBType.NotFound The Specified DBType does not found. 找不到指定的DBType。

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