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/ GaussDB(for MySQL)/ Referencia de la API/ Las API (recomendadas)/ Gestión de bases de datos/ Creación de una base de datos
Actualización más reciente 2023-12-14 GMT+08:00
Ver PDF
Compartir

Creación de una base de datos

Función

Esta API se utiliza para crear una base de datos para una instancia de GaussDB(for MySQL). Antes de invocar a esta API:

URI

POST /v3/{project_id}/instances/{instance_id}/databases

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.

instance_id

Sí

String

ID de instancia.

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.

X-Language

No

String

Idioma.
Tabla 3 Parámetros de body de solicitud

Parámetro

Obligatorio

Tipo

Descripción

databases

Sí

Array of CreateGaussMySqlDatabase objects

Lista de información de la base de datos. La lista contiene hasta 50 bases de datos.
Tabla 4 CreateGaussMySqlDatabase

Parámetro

Obligatorio

Tipo

Descripción

name

Sí

String

Nombre de la base de datos. El nombre puede contener entre 1 y 64 caracteres. Solo se permiten letras, dígitos, guiones (-), y guiones bajos (_). El número total de guiones (-) no puede exceder de 10.

character_set

Sí

String

Conjunto de caracteres de la base de datos, por ejemplo utf8mb4 o gbk.

users

No

Array of GaussMySqlDatabaseUser objects

Lista de usuarios de la base de datos. La lista contiene hasta 50 usuarios de base de datos. Al crear una base de datos, puede autorizar los permisos de base de datos a los usuarios de la lista. Si no hay ningún usuario de base de datos en la lista, no puede autorizar los permisos de base de datos a los usuarios de base de datos al crear una base de datos. Si necesita autorizar los permisos de la base de datos a un usuario de la base de datos más adelante, invoque la API para autorizar los permisos de la base de datos.
Tabla 5 GaussMySqlDatabaseUser

Parámetro

Obligatorio

Tipo

Descripción

name

Sí

String

Nombre de usuario de base de datos.

host

Sí

String

Dirección IP del host.

readonly

Sí

Boolean

Si el permiso es de solo lectura.

  • true: de solo lectura.
  • false: de lectura/escritura.

Parámetros de respuesta

Código de estado: 201

Tabla 6 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

job_id

String

ID de la tarea para crear una base de datos.

Código de estado: 400

Tabla 7 Parámetros de body 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 8 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Solicitud de ejemplo

Creación de una base de datos

POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/a23fb62bd61e4e9e9636fd2225f395bein07/databases
{
  "databases" : [ {
    "name" : "test",
    "character_set" : "utf8mb4",
    "users" : [ {
      "name" : "gaussdb_mysql_user1",
      "host" : "127.0.0.1",
      "readonly" : false
    } ]
  } ]
}

Ejemplo de respuesta

Código de estado: 201

Success.

{
  "job_id" : "dff1d289-4d03-4942-8b9f-463ea07c000d"
}

Código de estado

Para obtener más información, consulte Códigos de estado.

Código de error

Para obtener más información, consulte Códigos de error.

Tema principal: Gestión de bases de datos