开发者社区 问答 正文

API参考 - API参考 -参数管理 - DescribeParameterTemplates



描述


该接口返回参数模板列表,包含参数名、参数默认值、是否可修改、是否需要重启才能生效、参数校验规则(正则表达式)。
[tr=transparent] [/url]说明[tr=transparent]该接口只适用于MySQL和SQL Server类型的数据库。

请求参数

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述ActionString是系统规定参数,取值:DescribeParameterTemplates。EngineString是数据库类型,取值为MySQL或SQL Server。EngineVersionString是数据库版本号。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]公共参数。EngineString数据库类型。EngineVersionString数据库版本号。ParameterCountInteger参数个数。Parameters

List<TemplateRecord>参数列表,格式为{parameter1, parameter2, parameter3, …}。

TemplateRecord参数

[tr=rgb(51, 205, 229)][td]名称 类型描述ParameterNameString参数名。ParameterValueString参数默认值。ForceModifyStringFalse:不可修改;True:可修改。ForceRestartString
  • False:需要重启数据库才能生效
  • True:立即生效
CheckingCodeString校验代码,参数的可选范围,是一个正则表达式。ParameterDescriptionString参数描述。

请求示例



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"}

展开
收起
梨好橙 2018-09-15 22:40:18 1620 分享 版权
阿里云 AI 助理回答

根据您的描述,您想了解关于查询参数模板列表的接口详情,特别是针对MySQL和SQL Server类型的数据库。以下是该接口的详细说明及使用方法:

请求参数

  1. Action

    • 类型: String
    • 是否必须: 是
    • 描述: 系统规定参数,固定取值为:DescribeParameterTemplates
  2. Engine

    • 类型: String
    • 是否必须: 是
    • 描述: 数据库类型,可取值为 MySQLSQL Server
  3. EngineVersion

    • 类型: String
    • 是否必须: 是
    • 描述: 数据库版本号。对于MySQL,可选版本为5.1、5.5或5.6;对于SQL Server,可选版本为2008r2、2012_web或2016_web。

返回参数

  • EngineEngineVersion 重复提及,确认了查询结果将包含所查询的数据库类型及版本信息。
  • ParameterCount
    • 类型: Integer
    • 描述: 返回的参数总数。
  • ParametersList
    • 格式: {parameter1, parameter2, parameter3, …}
    • 描述: 参数列表,包含多个参数详情。

TemplateRecord 中的参数详情

  • ParameterName
    • 类型: String
    • 描述: 参数名。
  • ParameterValue
    • 类型: String
    • 描述: 参数默认值。
  • ForceModify
    • 类型: String
    • 描述: 修改权限,False 表示不可修改,True 表示可修改。
  • ForceRestart
    • 类型: String
    • 描述: 是否需要重启数据库以使修改生效,False 表示需要重启,True 表示立即生效(此描述与原始文档中的逻辑相反,请根据实际API行为理解)。
  • CheckingCode
    • 类型: String
    • 描述: 参数校验规则,正则表达式形式,定义了参数的有效输入范围。
  • ParameterDescription
    • 类型: String
    • 描述: 参数的详细描述。

请求示例

https://rds.aliyuncs.com/?Action=DescribeParameterTemplates

请注意,实际调用时还需根据阿里云API要求添加AccessKeyId、Signature等认证信息,并且确保请求参数符合API规范。此外,关于ForceRestart字段的解释可能存在误导,请参考官方文档或直接通过API测试来验证其实际含义。

参考资料: - [1] 接口描述与参数定义来源于用户问题中提及的信息。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答