描述
该接口返回参数模板列表,包含参数名、参数默认值、是否可修改、是否需要重启才能生效、参数校验规则(正则表达式)。
[tr=transparent]
[/url]说明[tr=transparent]该接口只适用于MySQL和SQL Server类型的数据库。
请求参数
[tr=rgb(51, 205, 229)][td]名称
类型 | 是否必须 | 描述 |
Action | String | 是 | 系统规定参数,取值:DescribeParameterTemplates。 |
Engine | String | 是 | 数据库类型,取值为MySQL或SQL Server。 |
EngineVersion | String | 是 | 数据库版本号。MySQL数据库为5.1、5.5或5.6,SQL Server数据库为2008r2、2012_web或2016_web。 |
返回参数
[tr=rgb(51, 205, 229)][td]名称
类型 | 描述 |
<公共返回参数> | | 详见[url=https://help.aliyun.com/document_detail/26224.html]公共参数。 |
Engine | String | 数据库类型。 |
EngineVersion | String | 数据库版本号。 |
ParameterCount | Integer | 参数个数。 |
Parameters |
List<TemplateRecord> | 参数列表,格式为{parameter1, parameter2, parameter3, …}。 |
TemplateRecord参数
[tr=rgb(51, 205, 229)][td]名称
类型 | 描述 |
ParameterName | String | 参数名。 |
ParameterValue | String | 参数默认值。 |
ForceModify | String | False:不可修改;True:可修改。 |
ForceRestart | String |
- False:需要重启数据库才能生效
- True:立即生效
|
CheckingCode | String | 校验代码,参数的可选范围,是一个正则表达式。 |
ParameterDescription | String | 参数描述。 |
请求示例https:
//rds.aliyuncs.com/?Action=DescribeParameterTemplates&Engine=SQLServer&EngineVersion=2008r2&<公共请求参数>返回示例XML格式
<DescribeParameterTemplatesResponse><Engine>mssql
</Engine><EngineVersion>2008r2
</EngineVersion><ParameterCount>1
</ParameterCount><Parameters><TemplateRecord><CheckingCode>[0-100]
</CheckingCode><ForceRestart>True
</ForceRestart><Factor>1
</Factor><ParameterDescription>此选项设置服务器范围内的默认填充因子值。提供填充因子是为了优化索引数据存储和性能。
</ParameterDescription><ParameterName>fill factor
</ParameterName><ParameterValue>0
</ParameterValue><ForceModify>True
</ForceModify><Unit>INT
</Unit></TemplateRecord></Parameters><RequestId>7B96585A-0FF2-4979-8FE5-7D147A29FDC0
</RequestId></DescribeParameterTemplatesResponse>JSON格式
{"Engine":
"mssql","EngineVersion":
"2008r2","ParameterCount":
1"Parameters": {"TemplateRecord": [{"ParameterDescription":
"此选项设置服务器范围内的默认填充因子值。提供填充因子是为了优化索引数据存储和性能。","ForceRestart":
"True","CheckingCode":
"[0-100]""Factor":
"1""ParameterName":
"fill factor""ParameterValue":
"0""ForceModify":
"True""Unit":
"INT"}]},"RequestId":
"7B96585A-0FF2-4979-8FE5-7D147A29FDC0"}
阿里云 AI 助理回答
根据您的描述,您想了解关于查询参数模板列表的接口详情,特别是针对MySQL和SQL Server类型的数据库。以下是该接口的详细说明及使用方法:
请求参数
-
Action
- 类型: String
- 是否必须: 是
- 描述: 系统规定参数,固定取值为:
DescribeParameterTemplates
。
-
Engine
- 类型: String
- 是否必须: 是
- 描述: 数据库类型,可取值为
MySQL
或 SQL Server
。
-
EngineVersion
- 类型: String
- 是否必须: 是
- 描述: 数据库版本号。对于MySQL,可选版本为5.1、5.5或5.6;对于SQL Server,可选版本为2008r2、2012_web或2016_web。
返回参数
- Engine 和 EngineVersion 重复提及,确认了查询结果将包含所查询的数据库类型及版本信息。
- ParameterCount
- ParametersList
- 格式: {parameter1, parameter2, parameter3, …}
- 描述: 参数列表,包含多个参数详情。
TemplateRecord 中的参数详情
- ParameterName
- ParameterValue
- ForceModify
- 类型: String
- 描述: 修改权限,
False
表示不可修改,True
表示可修改。
- ForceRestart
- 类型: String
- 描述: 是否需要重启数据库以使修改生效,
False
表示需要重启,True
表示立即生效(此描述与原始文档中的逻辑相反,请根据实际API行为理解)。
- CheckingCode
- 类型: String
- 描述: 参数校验规则,正则表达式形式,定义了参数的有效输入范围。
- ParameterDescription
请求示例
https://rds.aliyuncs.com/?Action=DescribeParameterTemplates
请注意,实际调用时还需根据阿里云API要求添加AccessKeyId、Signature等认证信息,并且确保请求参数符合API规范。此外,关于ForceRestart
字段的解释可能存在误导,请参考官方文档或直接通过API测试来验证其实际含义。
参考资料: - [1] 接口描述与参数定义来源于用户问题中提及的信息。