调用DescribeParameterGroup接口查询目标参数模板详情。

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

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

调试

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

请求参数

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

系统规定参数。取值：DescribeParameterGroup。
RegionId String 是 cn-hangzhou

地域ID。

说明 您可以通过DescribeRegions接口查看当前账号下的所有可用地域信息，包括地域ID。
ParameterGroupId String 是 pcpg-**************

参数模板ID。

说明 您可以通过DescribeParameterGroups接口查询目标地域下所有参数模板的详细信息，包括参数模板ID。
ResourceGroupId String 否 rg-************

资源组ID。

返回数据

名称 类型 示例值 描述
RequestId String F1F16757-D31B-49CA-9BF4-305BAF******

请求ID。
ParameterGroup Array of ParameterGroup

参数模板信息列表。
DBType String MySQL

数据库引擎类型。
DBVersion String 8.0

数据库引擎版本号。
ParameterGroupName String test

参数模板名称。
ForceRestart String 1

应用该参数模板是否需要重启集群，取直范围如下：

  • 0：不需要重启
  • 1：需要重启
ParameterGroupType String 1

参数模板类型，取值范围如下：

  • 0：系统默认模板
  • 1：用户自定义模板
  • 2：系统自动备份模板（应用模板后系统会自动备份之前的参数设置为模板）
ParameterCounts Integer 2

参数模板内的参数数量。
ParameterGroupDesc String testgroup

参数模板描述。
CreateTime String 2023-03-10T08:40:39Z

参数模板创建时间，格式为yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
ParameterDetail Array of ParameterDetail

参数列表。
ParamValue String 3000

参数值。
ParamName String back_log

参数名称。
ParameterGroupId String pcpg-**************

参数模板ID。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=DescribeParameterGroup
&RegionId=cn-hangzhou
&ParameterGroupId=pcpg-**************
&ResourceGroupId=rg-************
&<公共请求参数>

正常返回示例

XML格式

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

<DescribeParameterGroupResponse>
    <RequestId>F1F16757-D31B-49CA-9BF4-305BAF******</RequestId>
    <ParameterGroup>
        <DBType>MySQL</DBType>
        <DBVersion>8.0</DBVersion>
        <ParameterGroupName>test</ParameterGroupName>
        <ForceRestart>1</ForceRestart>
        <ParameterGroupType>1</ParameterGroupType>
        <ParameterCounts>2</ParameterCounts>
        <ParameterGroupDesc>testgroup</ParameterGroupDesc>
        <CreateTime>2023-03-10T08:40:39Z</CreateTime>
        <ParameterDetail>
            <ParamValue>3000</ParamValue>
            <ParamName>back_log</ParamName>
        </ParameterDetail>
        <ParameterGroupId>pcpg-**************</ParameterGroupId>
    </ParameterGroup>
</DescribeParameterGroupResponse>

JSON格式

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

{
  "RequestId" : "F1F16757-D31B-49CA-9BF4-305BAF******",
  "ParameterGroup" : [ {
    "DBType" : "MySQL",
    "DBVersion" : "8.0",
    "ParameterGroupName" : "test",
    "ForceRestart" : "1",
    "ParameterGroupType" : "1",
    "ParameterCounts" : 2,
    "ParameterGroupDesc" : "testgroup",
    "CreateTime" : "2023-03-10T08:40:39Z",
    "ParameterDetail" : [ {
      "ParamValue" : "3000",
      "ParamName" : "back_log"
    } ],
    "ParameterGroupId" : "pcpg-**************"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidRegionId.Malformed The specified parameter RegionId is not valid. 指定的参数RegionId无效。
400 InvalidParameterGroupId.Malformed The Specified parameter ParameterGroupId is not valid. 指定的参数ParameterGroupId无效

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