ApsaraDB RDS:CreateDBInstance

El ID de la región. Puede llamar a la operación DescribeRegions para consultar el ID de la región.

El motor de base de datos. Valores válidos:

• MySQL

• SQLServer

• PostgreSQL

• MariaDB

La versión del motor de base de datos. Valores válidos:

• Instancias regulares

  • MySQL: 5.5, 5.6, 5.7 y 8.0

  • SQL Server: 08r2_ent_ha (edición de disco en la nube, descontinuada), 2008r2 (edición de SSD local de alto rendimiento, descontinuada), 2012 (Enterprise Edition Standalone), 2012_ent_ha, 2012_std_ha, 2012_web, 2014_ent_ha, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_ent, 2017_std_ha, 2017_web, 2019_ent, 2019_std_ha, 2019_web, 2022_ent, 2022_std_ha, 2022_web, 2025_ent y 2025_std

  • PostgreSQL: 10.0, 11.0, 12.0, 13.0, 14.0, 15.0, 16.0, 17.0 y 18.0

  • MariaDB: 10.3 y 10.6

• Instancias sin servidor

  • MySQL: 5.7 y 8.0

  • SQL Server: 2016_std_sl, 2017_std_sl y 2019_std_sl

  • PostgreSQL: 14.0, 15.0, 16.0, 17.0 y 18.0

El tipo de instancia. Puede especificar un tipo de instancia estándar o Yitian. Para más detalles, consulte Tipos de instancia primaria.

Para crear una instancia sin servidor, especifique uno de los siguientes valores:

• MySQL Basic Edition: mysql.n2.serverless.1c

• Serie de alta disponibilidad de MySQL: mysql.n2.serverless.2c

• SQL Server: mssql.mem2.serverless.s2

• PostgreSQL Basic Edition: pg.n2.serverless.1c

• Serie de alta disponibilidad de PostgreSQL: pg.n2.serverless.2c

La capacidad de almacenamiento de la instancia. Unidad: GB. La capacidad de almacenamiento de la instancia aumenta en incrementos de 5 GB. Para más información sobre los valores válidos, consulte Tipos de instancia.

Este parámetro está obsoleto y no es necesario configurarlo.

El tipo de conectividad de red de la instancia. Establezca el valor en Intranet, que indica una conexión de red interna.

El nombre de la instancia. El nombre debe tener entre 2 y 255 caracteres de longitud. Debe comenzar con una letra y puede contener dígitos, letras y guiones (-).

La lista blanca de direcciones IP de la instancia. Separe varias entradas con comas (,). No se permiten entradas duplicadas. Puede agregar hasta 1,000 direcciones IP o bloques CIDR a la lista blanca de una sola instancia. Se admiten los siguientes formatos:

• Formato de dirección IP, por ejemplo, 10.10.XX.XX.

• Formato CIDR, por ejemplo, 10.10.XX.XX/24. En este ejemplo, 24 indica la longitud del prefijo en el bloque CIDR, y los valores válidos oscilan entre 1 y 32.

El token de cliente que se utiliza para garantizar la idempotencia de la solicitud y evitar envíos duplicados. Puede utilizar el cliente para generar el valor, pero debe asegurarse de que el valor sea único en las diferentes solicitudes. El valor puede contener un máximo de 64 caracteres ASCII y no puede contener caracteres que no sean ASCII.

El método de facturación de la instancia. Valores válidos:

• Postpaid: pago por uso.

• Prepaid: suscripción.

• Serverless: método de facturación sin servidor. No se admiten instancias de MariaDB. Para más información, consulte Descripción general de las instancias de ApsaraDB RDS for MySQL sin servidor, Descripción general de las instancias de ApsaraDB RDS for SQL Server sin servidor y Descripción general de las instancias de ApsaraDB RDS for PostgreSQL sin servidor.

El ID de zona del nodo primario.

• Si especifica una VPC y un vSwitch, debe especificar el ID de zona del vSwitch. De lo contrario, no se puede crear la instancia.

• Para una instancia de la serie de alta disponibilidad, también debe especificar ZoneIdSlave1 para determinar si la instancia utiliza un despliegue de zona única o de zonas múltiples.

• Para una instancia de RDS Enterprise Edition, también debe especificar ZoneIdSlave1 y ZoneIdSlave2 para determinar si la instancia utiliza un despliegue de zona única o de zonas múltiples.

• Para una instancia de ApsaraDB RDS Cluster Edition, también debe especificar ZoneIdSlave1 para una instancia de dos nodos, y ZoneIdSlave1 y ZoneIdSlave2 para una instancia de tres nodos.

El ID de zona del nodo secundario.

• Si establece el valor en Auto, indica un despliegue de zonas múltiples y el sistema selecciona automáticamente una zona para el nodo secundario.

• Si el valor es el mismo que el valor de ZoneId, es un despliegue de zona única.

• Si el valor es diferente del valor de ZoneId, es un despliegue de zonas múltiples.

Cuando crea una instancia de ApsaraDB RDS for MySQL Cluster Edition, puede crear uno o dos nodos secundarios al mismo tiempo. Si desea crear un segundo nodo secundario, puede utilizar este parámetro para especificar la zona del segundo nodo secundario.

El tipo de red de la instancia. Valores válidos:

• VPC: VPC.

• Classic: red clásica.

El modo de acceso de la instancia. Valores válidos:

• Standard: modo de acceso estándar.

• Safe: modo de proxy de base de datos.

El valor predeterminado es asignado por el sistema RDS.

El ID de la VPC.

El ID del vSwitch.

• Asignación de zonas: La zona del vSwitch especificado por VSwitchId debe coincidir con la zona del nodo primario (ZoneId) y la zona del nodo secundario (ZoneIdSlave1). Si especifica dos ID de vSwitch, su orden debe coincidir con el orden de ZoneId y ZoneIdSlave1.

• Límite de tipo de red: InstanceNetworkType debe establecerse en VPC.

• Múltiples vSwitches: Si especifica ZoneIdSlave1 y el valor no es Auto, debe especificar dos ID de vSwitch y separarlos con una coma (,).

• Límites de caracteres: VSwitchId no puede contener caracteres especiales como espacios, !, #, ￥, & y %.

Configuración para la dirección IP de red interna de la instancia. La dirección IP debe estar dentro del rango de direcciones IP del vSwitch especificado. De forma predeterminada, el sistema asigna automáticamente una dirección IP basada en VPCId y vSwitchId.

La duración de la suscripción. Valores válidos:

• Si Period se establece en Year, los valores válidos de UsedTime son de 1 a 5.

• Si Period se establece en Month, los valores válidos de UsedTime son de 1 a 11.

El periodo de suscripción de la instancia de suscripción. Valores válidos:

• Year: suscripción anual.

• Month: suscripción mensual.

El ID del grupo de recursos.

El tipo de almacenamiento de la instancia. Valores válidos:

• local_ssd: SSD local de alto rendimiento (recomendado).

• general_essd: disco en la nube premium (recomendado).

• cloud_essd: ESSD PL1.

• cloud_essd2: ESSD PL2.

• cloud_essd3: ESSD PL3.

• cloud_ssd: SSD estándar (no recomendado y ya no disponible en algunas regiones).

El valor predeterminado de este parámetro se determina automáticamente en función del tipo de instancia especificado por DBInstanceClass:

• Si el tipo de instancia es un tipo de SSD local de alto rendimiento, el valor predeterminado es local_ssd.

• Si el tipo de instancia es un tipo de disco en la nube, el valor predeterminado es cloud_essd.

Los parámetros comerciales extendidos.

El ID de la clave utilizada para el cifrado de discos en la nube en la misma región. Si especifica este parámetro, el cifrado de discos en la nube se habilita y no se puede deshabilitar. También debe especificar RoleARN.

Puede ver el ID de la clave o crear una nueva clave en la consola de Key Management Service (KMS). Para más información, consulte Crear una CMK.

El descriptor de recurso global (ARN) para la autorización de la cuenta de servicio de ApsaraDB RDS para acceder a KMS. Puede llamar a la operación CheckCloudResourceAuthorized para consultar el ARN.

Especifica si se debe habilitar la renovación automática para la instancia. Este parámetro solo es válido cuando se crea una instancia de suscripción. Valores válidos:

• true

• false

La edición de la instancia. Valores válidos:

• Instancias regulares

  • Basic: Basic Edition.

  • HighAvailability: serie de alta disponibilidad.

  • cluster: Cluster Edition para MySQL o PostgreSQL.

  • AlwaysOn: Cluster Edition para SQL Server.

  • Finance: RDS Enterprise Edition.

  Nota

  Este parámetro es obligatorio cuando se crea una instancia de SQL Server RDS Enterprise Edition o Basic Edition Enterprise Edition. Por ejemplo, cuando se crea una instancia de Basic Edition 2022 RDS Enterprise Edition (2022_ent), debe establecer este parámetro en Basic.

• Instancias sin servidor

  • serverless_basic: Serverless Basic Edition. Este valor solo es aplicable a MySQL y PostgreSQL.

  • serverless_standard: serie de alta disponibilidad sin servidor. Este valor solo es aplicable a MySQL y PostgreSQL.

  • serverless_ha: serie de alta disponibilidad sin servidor de SQL Server.

  Nota

  Este parámetro es obligatorio cuando PayType se establece en Serverless.

El ID del grupo de hosts del clúster dedicado.

Este parámetro es obligatorio cuando se crea una instancia de ApsaraDB RDS en un clúster dedicado.

• Puede llamar a la operación DescribeDedicatedHostGroups para consultar la información del grupo de hosts.

• Si no ha creado un grupo de hosts, puede llamar a la operación CreateDedicatedHostGroup para crear uno.

El ID del host en el que se crea la instancia primaria en el clúster dedicado.

Este parámetro es obligatorio cuando se crea una instancia de ApsaraDB RDS en un clúster dedicado. Si no especifica este parámetro, el sistema asigna automáticamente un host.

• Puede llamar a la operación DescribeDedicatedHosts para consultar la información de los hosts en el grupo de hosts.

• Si no tiene un host, puede llamar a la operación CreateDedicatedHost para agregar uno.

El ID del host en el que se crea la instancia secundaria en el clúster dedicado.

Este parámetro es obligatorio cuando se crea una instancia de la serie de alta disponibilidad de ApsaraDB RDS o de RDS Enterprise Edition en un clúster dedicado. Si no especifica este parámetro, el sistema asigna un host de forma predeterminada.

• Puede invocar la operación DescribeDedicatedHosts para consultar la información de los hosts en el clúster dedicado.

• Si no tiene un host, puede llamar a la operación CreateDedicatedHost para agregar uno.

El ID del host en el que se crea el nodo de registro en el clúster dedicado.

Este parámetro es obligatorio cuando se crea una instancia de ApsaraDB RDS Enterprise Edition en un clúster dedicado. Si no especifica este parámetro, el sistema asigna automáticamente un host.

• Puede llamar a la operación DescribeDedicatedHosts para consultar la información de los hosts en el clúster dedicado.

• Si no tiene un host, puede llamar a la operación CreateDedicatedHost para agregar uno.

El ID de la plantilla de parámetros. Puede llamar a la operación DescribeParameterGroups para consultar el ID de la plantilla de parámetros.

La zona horaria de la instancia. Este parámetro solo surte efecto cuando Engine se establece en MySQL o PostgreSQL.

• Si Engine se establece en MySQL:

  • La configuración del parámetro especifica la zona horaria UTC. Valores válidos: -12:59 a +13:00.

  • Para una instancia con SSD locales premium, puede utilizar una zona horaria con nombre, como Asia/Hong_Kong. Para más información sobre las zonas horarias con nombre, consulte Zonas horarias con nombre.

• Si Engine se establece en PostgreSQL:

  • Este parámetro especifica una zona horaria con nombre. No se admiten zonas horarias UTC. Para más información sobre las zonas horarias con nombre, consulte Zonas horarias con nombre.

  • Este parámetro solo se puede configurar para instancias de ApsaraDB RDS for PostgreSQL con discos en la nube.

Especifica si los nombres de las tablas distinguen entre mayúsculas y minúsculas. Valores válidos:

• true: Los nombres de las tablas no distinguen entre mayúsculas y minúsculas. Este es el valor predeterminado.

• false: Los nombres de las tablas distinguen entre mayúsculas y minúsculas.

La versión menor del motor de la instancia de ApsaraDB RDS. Este parámetro solo es obligatorio cuando se crea una instancia de MySQL o PostgreSQL. Formato:

• MySQL: <Instance version>_<Numeric version number>. Ejemplos: rds_20200229, xcluster_20200229 y xcluster80_20200229. Descripción:

  • rds: serie de alta disponibilidad o Basic Edition.

  • xcluster: MySQL 5.7 RDS Enterprise Edition.

  • xcluster80: MySQL 8.0 RDS Enterprise Edition.

  Nota

  Puede invocar la operación DescribeDBMiniEngineVersions para consultar el número de versión numérico. Para más información sobre las diferencias entre versiones, consulte Notas de la versión de AliSQL.

• PostgreSQL: rds_postgres_<Major version>00_<Minor version number>. Ejemplo: rds_postgres_1400_20220830. Descripción:

  • 1400: La versión principal de PostgreSQL es 14.

  • 20220830: La versión menor del kernel de AliPG. Puede llamar a la operación DescribeDBMiniEngineVersions para consultar la versión menor del motor. Para más información sobre las diferencias entre versiones, consulte Notas de la versión de AliPG.

  Nota

  Si Babelfish está habilitado en BabelfishConfig, el formato de la versión menor del motor para la instancia de ApsaraDB RDS for PostgreSQL es: rds_postgres_<Major version>00_<AliPG minor engine version>_babelfish.

Especifica si se debe habilitar la expansión automática de almacenamiento. Este parámetro solo es compatible con MySQL y PostgreSQL. Valores válidos:

• Enable: habilita la expansión automática de almacenamiento.

• Disable: deshabilita la expansión automática de almacenamiento. Este es el valor predeterminado.

El porcentaje de umbral que activa la expansión automática de almacenamiento. Valores válidos:

• 10

• 20

• 30

• 40

• 50

El límite superior de la capacidad total de almacenamiento para la expansión automática de almacenamiento. La expansión automática no hará que la capacidad total de almacenamiento de la instancia supere este valor. Unidad: GB.

Especifica si se debe realizar una comprobación previa para la operación de creación de la instancia. Valores válidos:

• true: realiza una comprobación previa pero no crea la instancia. Los elementos de comprobación incluyen los parámetros de la solicitud, el formato de la solicitud, los límites comerciales y el inventario.

• false: envía una solicitud normal y crea la instancia directamente después de que se apruebe la comprobación. Este es el valor predeterminado.

El ID de la copia de seguridad del usuario. Puede llamar a la operación ListUserBackupFiles para consultar el ID de la copia de seguridad. Si especifica este parámetro, la instancia se crea en función de la copia de seguridad del usuario.

Si especifica este parámetro, se aplican los siguientes límites:

• PayType debe establecerse en Postpaid.

• Engine debe establecerse en MySQL.

• EngineVersion debe establecerse en 5.7.

• Category debe establecerse en Basic.

El número de instancias de ApsaraDB RDS for MySQL que se van a crear. Este parámetro solo es aplicable cuando se crean varias instancias de ApsaraDB RDS for MySQL al mismo tiempo.

Valores válidos: 1 a 20. Valor predeterminado: 1.

La estrategia para crear varias instancias al mismo tiempo. Este parámetro solo surte efecto cuando el parámetro Amount es mayor que 1. Valores válidos:

• Atomicity (predeterminado): atomicidad. Todas las instancias en el mismo lote se crean con éxito o todas fallan si una instancia falla.

• Partial: no atomicidad. La creación de una instancia no se ve afectada por otras instancias en el mismo lote.

Especifica si se debe habilitar la función de protección contra liberación para la instancia de ApsaraDB RDS. Esta función solo es compatible con instancias de pago por uso. Valores válidos:

• true: habilita la función.

• false: deshabilita la función. Este es el valor predeterminado.

La información de configuración para Babelfish for ApsaraDB RDS for PostgreSQL.

Formato de configuración: {"babelfishEnabled":"true","migrationMode":"xxxxxxx","masterUsername":"xxxxxxx","masterUserPassword":"xxxxxxxx"}

Descripción de parámetros:

• babelfishEnabled: Especifica si se debe habilitar Babelfish. Establezca el valor en true para habilitar Babelfish. De forma predeterminada, Babelfish está deshabilitado.

• migrationMode: El modo de base de datos. Establezca el valor en single-db para el modo de base de datos única o multi-db para el modo de bases de datos múltiples.

• masterUsername: La cuenta de administrador inicial. El nombre de usuario debe tener entre 1 y 63 caracteres de longitud y puede contener letras minúsculas, dígitos y guiones bajos (_). Debe comenzar con una letra y terminar con una letra o un dígito. No puede comenzar con pg.

• masterUserPassword: La contraseña de la cuenta de administrador. La contraseña debe tener entre 8 y 32 caracteres de longitud y debe contener al menos tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales. Los caracteres especiales incluyen ! @ # $ % ^ & * () _ + - =.

El endpoint interno de la base de datos.

Formato del endpoint: xxx.mysql.rds.aliyuncs.com, donde xxx es el prefijo del ID de la instancia, como rm-uf6wjk5***.

El puerto utilizado para inicializar la instancia de ApsaraDB RDS durante la creación. Valores válidos:

• MySQL: 1000 a 65534

• PostgreSQL, SQL Server y MariaDB: 1000 a 5999

Este parámetro está obsoleto y no es necesario configurarlo.

Especifica si se debe habilitar la función de ráfaga de rendimiento de E/S para discos en la nube premium. Valores válidos:

• true: habilita la función.

• false: deshabilita la función.

Especifica si se debe habilitar el pago automático. Valores válidos:

• true: habilita el pago automático. Debe asegurarse de que el saldo de su cuenta sea suficiente.

• false: genera un pedido sin deducir cargos.

Especifica si se debe habilitar la función de Buffer Pool Extension (BPE) para discos en la nube premium. Valores válidos:

• 1: habilita la función.

• 0: deshabilita la función.

Especifica si se debe habilitar la función de archivado de datos para discos en la nube premium. Valores válidos:

• true: habilita la función.

• false: deshabilita la función.

Las plantillas de lista blanca. Cuando necesite configurar varias direcciones IP, separe varias direcciones IP o bloques CIDR con comas (,). No agregue espacios antes o después de las comas. Ejemplo: 192.168.0.1,172.16.213.9.

Especifica si se debe crear automáticamente un proxy. Valores válidos:

• true: habilita la creación automática. De forma predeterminada, se crea un proxy de uso general.

• false: deshabilita la creación automática. [_single

Specifies whether to use a voucher. Valid values:

• true: uses a voucher.

• false (default): does not use a voucher.

The coupon code.

Specifies whether to enable the 16KB atomic write feature. Valid values:

• optimized: enables the feature.

• none (default): disables the feature.

Specifies whether to enable native replication for ApsaraDB RDS for MySQL. Valid values:

• ON: enables native replication.

• OFF: disables native replication.