Creating a Parameter Template

Function

This API is used to create a parameter template and configure the name, description, DB engine, and parameter values in the parameter template.

• Before calling an API, you need to understand the API in Authentication.

Constraints

• The new parameter template cannot have the same name as any existing parameter template.

URI

• URI format

  POST /v3/{project_id}/configurations

• Parameter description

  Table 1 Parameter description

  Name	Mandatory	Description
  project_id	Yes	Specifies the project ID of a tenant in a region. For details about how to obtain the project ID, see Obtaining a Project ID.

Request

Example Request

Creating a parameter template named configuration_test

{
	"name": "configuration_test",
	"description": "configuration_test",
	"values": {
                "div_precision_increment": "6",
                "connect_timeout": "20"
	},
	"datastore": {
		"type": "mysql",
		"version": "5.7"
	}
}

Response

• Normal response

  Table 4 Parameter description

  Name	Type	Description
  configuration	Object	Indicates the parameter template information. For details, see Table 5.

  Table 5 configuration field data structure description

  Name	Type	Description
  id	String	Indicates the parameter template ID.
  name	String	Indicates the parameter template name.
  datastore_version_name	String	Indicates the database version name.
  datastore_name	String	Indicates the database name.
  description	String	Indicates the parameter template description.
  created	String	Indicates the creation time in the following format: yyyy-MM-ddTHH:mm:ssZ. T is the separator between the calendar and the hourly notation of time. Z indicates the time zone offset. For example, in the Beijing time zone, the time zone offset is shown as +0800.
  updated	String	Indicates the update time in the following format: yyyy-MM-ddTHH:mm:ssZ. T is the separator between the calendar and the hourly notation of time. Z indicates the time zone offset. For example, in the Beijing time zone, the time zone offset is shown as +0800.

• Example normal response

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

• Abnormal response

  For details, see Abnormal Request Results.

Status Code

• Normal

  200

• Abnormal

  For details, see Status Codes.

Error Code

For details, see Error Codes.