创建参数模板

功能介绍

创建参数模板信息，包含参数模板名称、描述、数据库版本信息、参数值。

• 调用接口前，您需要了解API 认证鉴权。

调试

您可以在API Explorer中调试该接口。

接口约束

• 支持的数据库引擎：MySQL、PostgreSQL、Microsoft SQL Server。

• 创建参数模板的name名称不能与默认参数模板或已有参数模板的名称重复。

URI

• URI格式

  POST /v3/{project_id}/configurations

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一Region下的项目ID。 获取方法请参见获取项目ID。

请求消息

请求示例

创建参数模板configuration_test。

POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/configurations
{
	"name": "configuration_test",
	"description": "configuration_test",
	"values": {
                "div_precision_increment": "6",
                "connect_timeout": "20"
	},
	"datastore": {
		"type": "mysql",
		"version": "5.7"
	}
}

响应消息

• 正常响应要素说明

  表4 要素说明

  名称	参数类型	说明
  configuration	Object	参数模板信息。 详情请参见表5。

  表5 configuration字段数据结构说明

  名称	参数类型	说明
  id	String	参数模板ID。
  name	String	参数模板名称。
  datastore_version_name	String	数据库版本名称。
  datastore_name	String	数据库名称。
  description	String	描述。
  created	String	创建时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。
  updated	String	更新时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。

• 正常响应样例

  {
  	"configuration": {
  		"id": "463b4b58-d0e8-4e2b-9560-5dea4552fde9",
  		"name": "configuration_test",
  		"datastore_version_name": "5.7",
  		"datastore_name": "mysql",
  		"description": "configuration_test",
  		"created": "2017-04-09T08:27:56+0800",
  		"updated": "2017-04-09T08:27:56+0800"
                  
  	}
  }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。