调用DescribeParameterGroups接口查询目标地域的参数模板列表。

参数模板可以批量管理实例的参数,您可以使用参数模板功能,快速应用模板到实例上。详情请参见MySQL使用参数模板PostgreSQL使用参数模板

说明 当前仅支持MySQL实例和PostgreSQL实例。

调试

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

请求参数

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

系统规定参数。取值:DescribeParameterGroups

RegionId String cn-hangzhou

地域ID,可以通过DescribeRegions查看地域ID。

ResourceGroupId String rg-acfmy****

资源组ID。

返回数据

名称 类型 示例值 描述
SignalForOptimizeParams Boolean false

目标地域是否有参数模板。取值:

  • true:无参数模板
  • false:有参数模板
RequestId String D4A23265-C5B6-42E1-98A0-EFA1EB42E723

请求ID。

ParameterGroups Array of ParameterGroup

参数模板列表。

ParameterGroup
UpdateTime String 2019-11-21T02:21:35Z

最近一次参数模板更新时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

ParameterGroupDesc String 1

参数模板类型。取值:

  • 0:系统默认模板
  • 1:用户自定义模板
  • 2:系统自动备份模板(应用模板后系统会自动备份之前的参数设置为模板)
CreateTime String 2019-11-21T01:48:39Z

参数模板创建时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

ForceRestart Integer 1

应用该参数模板是否需要重启实例。取值:

  • 0:不需要重启
  • 1:需要重启
ParameterGroupId String rpg-****

参数模板ID。

ParameterGroupName String test1234

参数模板名称。

Engine String mysql

数据库引擎。

ParamCounts Integer 2

参数模板内的参数数量。

EngineVersion String 5.7

数据库版本。

ParameterGroupType Integer 1

参数模板类型。取值:

  • 0:系统默认模板
  • 1:用户自定义模板
  • 2:系统自动备份模板(应用模板后系统会自动备份之前的参数设置为模板)

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeParameterGroups
&RegionId=cn-hangzhou
&公共请求参数

正常返回示例

XML格式

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

<DescribeParameterGroupsResponse>
    <SignalForOptimizeParams>false</SignalForOptimizeParams>
    <RequestId>D4A23265-C5B6-42E1-98A0-EFA1EB42E723</RequestId>
    <ParameterGroups>
        <UpdateTime>2019-11-21T02:21:35Z</UpdateTime>
        <ParameterGroupDesc>1</ParameterGroupDesc>
        <CreateTime>2019-11-21T01:48:39Z</CreateTime>
        <ForceRestart>1</ForceRestart>
        <ParameterGroupId>rpg-****</ParameterGroupId>
        <ParameterGroupName>test1234</ParameterGroupName>
        <Engine>mysql</Engine>
        <ParamCounts>2</ParamCounts>
        <EngineVersion>5.7</EngineVersion>
        <ParameterGroupType>1</ParameterGroupType>
    </ParameterGroups>
</DescribeParameterGroupsResponse>

JSON格式

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

{
  "SignalForOptimizeParams" : false,
  "RequestId" : "D4A23265-C5B6-42E1-98A0-EFA1EB42E723",
  "ParameterGroups" : [ {
    "UpdateTime" : "2019-11-21T02:21:35Z",
    "ParameterGroupDesc" : "1",
    "CreateTime" : "2019-11-21T01:48:39Z",
    "ForceRestart" : 1,
    "ParameterGroupId" : "rpg-****",
    "ParameterGroupName" : "test1234",
    "Engine" : "mysql",
    "ParamCounts" : 2,
    "EngineVersion" : "5.7",
    "ParameterGroupType" : 1
  } ]
}

错误码

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