Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ TaurusDB/ Referencia de la API/ Las API (recomendadas)/ Gestión de plantillas de parámetros/ Creación de una plantilla de parámetros

Actualización más reciente 2025-03-21 GMT+08:00

Ver PDF

Creación de una plantilla de parámetros

Función

Esta API se utiliza para crear una plantilla de parámetro. Debe configurarse la siguiente información: nombre de la plantilla, descripción, versión del motor de base de datos y valores de parámetros. Antes de invocar a esta API:

Aprender cómo autorizar y autenticarla.
Obtenga la región y el punto de conexión requeridos.

Restricciones

Esta API solo está disponible para instancias de TaurusDB de clúster (edición dedicada).
El nombre de la plantilla de parámetros personalizada distingue entre mayúsculas y minúsculas y debe ser diferente del nombre de una plantilla de parámetros existente o predeterminada.
El valor de parameter_values en la plantilla de parámetros personalizada debe estar dentro del rango de valores predeterminado de la versión de base de datos especificada.

URI

POST /v3/{project_id}/configurations

**Tabla 1** Parámetros de URI
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID de proyecto de un tenant en una región. Para obtener este valor, consulte Obtención de un ID de proyecto.

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario. Para obtener este valor, invoque a la API de IAM para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el valor del token.
X-Language	No	String	Tipo de idioma de solicitud. El valor predeterminado es en-us. Valores: en-us zh-cn

**Tabla 3** Parámetros del cuerpo de solicitud
Parámetro	Obligatorio	Tipo	Descripción
name	Sí	String	Nombre de la plantilla del parámetro. El nombre de la plantilla puede contener de 1 a 64 caracteres. Solo se permiten letras (distinguiendo mayúsculas y minúsculas), dígitos, guiones (-), guiones bajos (_), y puntos (.).
description	No	String	Descripción de la plantilla de parámetros. El valor se deja en blanco de forma predeterminada. La descripción puede contener un máximo de 256 caracteres y no puede contener el carácter de retorno de carro ni los siguientes caracteres especiales: !<"='>&
parameter_values	No	Map<String,String>	Asignación entre nombres de parámetros y valores de parámetros. Puede especificar valores de parámetros basados en una plantilla de parámetros predeterminada.
datastore	No	DatastoreResult object	Objeto de base de datos.

**Tabla 4** DatastoreResult
Parámetro	Obligatorio	Tipo	Descripción
type	Sí	String	Motor de base de datos. Actualmente, solo se admite gaussdb-mysql.
version	Sí	String	Versión de base de datos. Para obtener detalles sobre las versiones de BD soportadas, véase Consulta de información de versión acerca de un motor de base de datos.

Parámetros de respuesta

Código de estado: 200

**Tabla 5** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
configurations	ConfigurationSummary2 object	Información de la plantilla de parámetros.

**Tabla 6** ConfigurationSummary2
Parámetro	Tipo	Descripción
id	String	ID de plantilla de parámetro.
name	String	Nombre de la plantilla del parámetro.
description	String	Descripción de la plantilla de parámetros.
datastore	DatastoreResult object	Objeto de base de datos.
created	String	Tiempo de creación en el formato "yyyy-MM-ddTHH:mm:ssZ". T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria.
updated	String	Tiempo de actualización en el formato "yyyy-MM-ddTHH:mm:ssZ". T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria.

**Tabla 7** DatastoreResult
Parámetro	Tipo	Descripción
type	String	Motor de base de datos. Actualmente, solo se admite gaussdb-mysql.
version	String	Versión de base de datos. Para obtener detalles sobre las versiones de BD soportadas, véase Consulta de información de versión acerca de un motor de base de datos.

Código de estado: 400

**Tabla 8** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.

Código de estado: 500

**Tabla 9** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.

Ejemplo de la solicitud

Creación de una plantilla de parámetro (Existen hasta 10 conexiones simultáneas para la cuenta.)

POST https://{endpoint}/v3/056538411200d4cd2f79c003c7606412/configurations
{
  "name" : "myparameter",
  "description" : "parameter1",
  "datastore" : {
    "type" : "gaussdb-mysql",
    "version" : "8.0"
  },
  "parameter_values" : {
    "max_user_connections" : "10"
  }
}

Ejemplo de respuesta

Código de estado: 200

Operación exitosa.

{
  "configurations" : {
    "id" : "887ea0d1bb0843c49e8d8e5a09a95652pr07",
    "name" : "myparameter",
    "description" : "parameter1",
    "datastore" : {
      "type" : "gaussdb-mysql",
      "version" : "8.0"
    },
    "created" : "2022-05-15T11:53:34+0000",
    "updated" : "2022-05-15T11:53:34+0000"
  }
}