Criação de um modelo de parâmetro

Função

Esta API é usada para criar um modelo de parâmetro e configurar o nome, a descrição, o mecanismo de banco de dados e os valores de parâmetros no modelo de parâmetro.

• Antes de chamar uma API, você precisa entender a API em Autenticação.

Restrições

• Os seguintes mecanismos de banco de dados são suportados: MySQL, Microsoft SQL Server, e PostgreSQL.

• O nome do modelo de parâmetro criado não pode ser igual ao do modelo de parâmetro padrão ou existente.

URI

• Formato de URI

  POST /v3/{project_id}/configurations

• Descrição do parâmetro

  Tabela 1 Descrição do parâmetro

  Nome	Obrigatório	Descrição
  project_id	Sim	Especifica o ID do projeto de um locatário em uma região. Para obter detalhes sobre como obter o ID do projeto, consulte Obtenção de um ID de projeto.

Solicitação

• Descrição do parâmetro

  Tabela 2 Descrição do parâmetro

  Nome	Obrigatório	Tipo	Descrição
  name	Sim	String	Especifica o nome do modelo de parâmetro. Ele contém no máximo 64 caracteres e pode conter apenas letras maiúsculas, minúsculas, dígitos, hifens (-), sublinhados (_) e pontos (.).
  description	Não	String	Especifica a descrição do modelo de parâmetro. Ela contém um máximo de 256 caracteres e não pode conter os seguintes caracteres especiais: >!<"&'= O valor dela é deixado em branco por padrão.
  values	Não	Map<String,String>	Especifica os valores de parâmetros definidos pelos usuários com base nos modelos de parâmetros padrão. Por padrão, os valores dos parâmetros não são alterados. key: nome do parâmetro. Por exemplo, em "max_connections": "10", a chave é max_connections. Se key estiver deixada em branco, o valor do parâmetro não é alterado. Se key não estiver vazia, o parâmetro value também não poderá estar vazio. value: valor do parâmetro. Por exemplo, em "max_connections": "10", o valor é 10.
  datastore	Sim	Object	Especifica o objeto de banco de dados. Para obter detalhes, consulte Tabela 3.

  Tabela 3 Descrição da estrutura de dados do campo datastore

  Nome	Obrigatório	Tipo	Descrição
  type	Sim	String	Especifica o mecanismo de banco de dados. O valor dele pode ser qualquer um dos seguintes e não diferencia entre maiúsculas e minúsculas: MySQL PostgreSQL SQLServer
  version	Sim	String	Especifica a versão de banco de dados. Para obter detalhes, consulte Restrições. Exemplo de valores: MySQL: 5.7 PostgreSQL: 9.5 Microsoft SQL Server: 2014_SE

• Exemplo

  POST https://rds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/configurations

• Exemplo de solicitação

  {
  	"name": "configuration_test",
  	"description": "configuration_test",
  	"values": {
  		"max_connections": "10",
  		"autocommit": "OFF"
  	},
  	"datastore": {
  		"type": "mysql",
  		"version": "5.7"
  	}
  }

Resposta

• Resposta normal

  Tabela 4 Descrição do parâmetro

  Nome	Tipo	Descrição
  configuration	Object	Indica as informações do modelo de parâmetro. Para obter detalhes, consulte Tabela 5.

  Tabela 5 Descrição da estrutura de dados do campo configuration

  Nome	Tipo	Descrição
  id	String	Indica o ID do modelo de parâmetro.
  name	String	Indica o nome do modelo de parâmetro.
  datastore_version_name	String	Indica o nome da versão de banco de dados.
  datastore_name	String	Indica o nome de banco de dados.
  description	String	Indica a descrição do modelo de parâmetro.
  created	String	Indica o tempo de criação no seguinte formato: yyyy-MM-ddTHH:mm:ssZ. T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, no fuso horário de Pequim, o deslocamento do fuso horário é mostrado como +0800.
  updated	String	Indica o tempo de atualização no seguinte formato: yyyy-MM-ddTHH:mm:ssZ. T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, no fuso horário de Pequim, o deslocamento do fuso horário é mostrado como +0800.

• Exemplo de resposta normal

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

• Resposta anormal

  Para obter detalhes, consulte Resultados anormais da solicitação.

Código de status

• Normal

  200

• Anormal

  Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.