Todos los productos
Search
Centro de documentos

:Cree una base de datos

Última actualización: Sep 03, 2026

Puede llamar a la operación CreateDatabase para crear una base de datos en una instancia.

Si desea administrar datos, como modificar información o diseñar esquemas, utilice Data Management (DMS). Para obtener más información, consulte Lista de operaciones por función de DMS.

Antes de llamar a esta operación, asegúrese de cumplir con los requisitos a continuación:

  • La instancia se encuentra en estado Running.

  • No se ha alcanzado el número máximo de bases de datos para la instancia. Llame a la operación DescribeDBInstanceAttribute para consultar este límite.

  • La instancia no es de solo lectura.

    Nota

    Esta operación no es compatible con instancias que ejecutan SQL Server 2017 EE (cluster edition) ni con instancias que ejecutan PostgreSQL y utilizan discos SSD locales. Si la instancia ejecuta alguna de estas versiones del motor de base de datos, ejecute la sentencia CREATE DATABASE para crear una base de datos.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

ParámetroTipoObligatorioEjemploDescripción
ActionStringSíCreateDatabase

La operación que desea ejecutar. Establezca el valor en CreateDatabase.

DBInstanceIdStringSírm-uf6wjk5xxxxxxxxxx

El ID de la instancia.

DBNameStringSírds_mysql

El nombre de la base de datos.

Nota
  • El nombre debe tener entre 2 y 64 caracteres.
  • El nombre debe comenzar con una letra minúscula y terminar con una letra minúscula o un dígito.
  • El nombre puede contener letras minúsculas, dígitos, guiones bajos (_) y guiones (-).
  • El nombre debe ser único dentro de la instancia.
  • Para obtener más información sobre caracteres no válidos, consulte la Tabla de palabras clave prohibidas.
CharacterSetNameStringSígbk

El conjunto de caracteres.

  • Valores válidos para bases de datos MySQL o MariaDB: utf8, gbk, latin1 y utf8mb4
  • Valores válidos para bases de datos SQL Server: Chinese_PRC_CI_AS, Chinese_PRC_CS_AS, SQL_Latin1_General_CP1_CI_AS, SQL_Latin1_General_CP1_CS_AS y Chinese_PRC_BIN
  • Valores válidos para bases de datos PostgreSQL: un valor con el formato Character set,<Collate>,<Ctype>. Ejemplo: UTF8,C,en_US.utf8.
    • Valores válidos para el conjunto de caracteres: KOI8U, UTF8, WIN866, WIN874, WIN1250, WIN1251, WIN1252, WIN1253, WIN1254, WIN1255, WIN1256, WIN1257, WIN1258, EUC_CN, EUC_KR, EUC_TW, EUC_JP, EUC_JIS_2004, KOI8R, MULE_INTERNAL, LATIN1, LATIN2, LATIN3, LATIN4, LATIN5, LATIN6, LATIN7, LATIN8, LATIN9, LATIN10, ISO_8859_5, ISO_8859_6, ISO_8859_7, ISO_8859_8 y SQL_ASCII
    • Valores válidos para el campo Collate: Ejecute la sentencia SELECT DISTINCT collname FROM pg_collation; para obtener el valor del campo. El valor predeterminado es C.
    • Valores válidos para el campo Ctype: Ejecute la sentencia SELECT DISTINCT collctype FROM pg_collation; para obtener el valor del campo. El valor predeterminado es en_US.utf8.
DBDescriptionStringNoTest database

La descripción de la base de datos. Debe tener entre 2 y 256 caracteres y puede contener letras, dígitos, guiones bajos (_) y guiones (-). Debe comenzar con una letra.

Nota La descripción no puede comenzar con http:// ni con https://.
ResourceGroupIdStringNorg-acfmy*****

El ID del resource group.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

RequestId

String

5A77D650-27A1-4E08-AD9E-59008EDB6927

El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://rds.aliyuncs.com/?Action=CreateDatabase
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&DBName=rds_mysql
&CharacterSetName=gbk
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDatabaseResponse>
  <RequestId>5A77D650-27A1-4E08-AD9E-59008EDB6927</RequestId>
</CreateDatabaseResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestID" : "5A77D650-27A1-4E08-AD9E-59008EDB6927"
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400

EngineMigration.ActionDisabled

Specified action is disabled while custins is in engine migration.

Este error indica que la operación especificada está deshabilitada durante la migración del motor de la instancia.

400

Database.AddError

Create Db failed, please check input value and instance status

Este error indica que no se pudo crear la base de datos. Compruebe los parámetros de entrada y el estado de la instancia.

400

Database.ConnectError

Database connect error. please check instance status and database processlist

Este error indica que la conexión a la base de datos es anómala. Compruebe el estado de la instancia y el pool de conexiones de la base de datos.

Para obtener una lista de códigos de error, visite el Centro de errores de API.