Crear una instancia - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación CreateDBInstance para crear una instancia de RDS.

Antes de llamar a esta operación, asegúrese de comprender los métodos de facturación y los precios de ApsaraDB RDS. Para obtener más información, consulte Elementos facturables, métodos de facturación y precios.

Para obtener más información sobre los tipos de instancias de ApsaraDB RDS, consulte Tipos de instancias principales de ApsaraDB RDS.

Depuración

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

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateDBInstance	La operación que desea ejecutar. Establezca el valor en CreateDBInstance.
RegionId	String	Sí	cn-hangzhou	El ID de región de la instancia. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
Engine	String	Sí	MySQL	El motor de base de datos de la instancia. Valores válidos: MySQL SQLServer PostgreSQL MariaDB Nota Para crear una instancia serverless, debe establecer este parámetro en MySQL.
EngineVersion	String	Sí	5.6	La versión del motor de base de datos de la instancia. Valores válidos cuando establece el parámetro Engine en MySQL: 5.5, 5.6, 5.7 y 8.0 Valores válidos cuando establece el parámetro Engine en SQLServer: 2008r2, 08r2_ent_ha, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_std_ha, 2017_ent, 2019_std_ha y 2019_ent Valores válidos cuando establece el parámetro Engine en PostgreSQL: 10.0, 11.0, 12.0, 13.0, 14.0 y 15.0 Valores válidos cuando establece el parámetro Engine en MariaDB: 10.3 Nota Para crear una instancia serverless, debe establecer este parámetro en 8.0.
DBInstanceClass	String	Sí	rds.mysql.s1.small	El tipo de la instancia. Para obtener más información, consulte Tipos de instancias principales de ApsaraDB RDS. También puede llamar a la operación DescribeAvailableResource para consultar los tipos de instancia disponibles en una región. Nota Para crear una instancia serverless, debe establecer este parámetro en mysql.n2.serverless.1c.
DBInstanceStorage	Integer	Sí	100	La capacidad de almacenamiento de la instancia. Unidad: GB. Puede aumentar la capacidad de almacenamiento en incrementos de 5 GB. Para obtener más información, consulte Tipos de instancias principales de ApsaraDB RDS. También puede llamar a la operación DescribeAvailableResource para consultar el rango de capacidad de almacenamiento compatible con un tipo de instancia específico en una región.
SystemDBCharset	String	No	gbk	El conjunto de caracteres que utiliza la instancia. Este parámetro está obsoleto.
DBInstanceNetType	String	Sí	Internet	El tipo de conexión de red a la instancia. Valores válidos: Internet: Internet Intranet: red interna
DBInstanceDescription	String	No	testdatabase	El nombre de la instancia. El nombre debe tener entre 2 y 255 caracteres de longitud y puede contener letras, dígitos, guiones bajos (_) y guiones (-). Debe comenzar con una letra. Nota El nombre no puede comenzar con http:// o https://.
SecurityIPList	String	Sí	10.10.XX.XX/24	La lista blanca de direcciones IP de la instancia. Para obtener más información, consulte Usar un cliente de base de datos o la CLI para conectarse a una instancia de ApsaraDB RDS for MySQL. Si la lista blanca de direcciones IP contiene más de una entrada, separe las entradas con comas (,). Cada entrada debe ser única. La lista blanca de direcciones IP puede contener hasta 1,000 entradas. Las entradas deben tener uno de los siguientes formatos: Direcciones IP, como 10.10.XX.XX. Bloques CIDR, como 10.10.XX.XX/24. En este ejemplo, 24 indica que el prefijo de cada dirección IP en la lista blanca tiene una longitud de 24 bits. Puede reemplazar 24 con un valor dentro del rango de 1 a 32.
ClientToken	String	No	ETnLKlblzczshOTUbOCz*****	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el valor, pero debe asegurarse de que sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII y no puede exceder los 64 caracteres de longitud.
PayType	String	Sí	Postpaid	El método de facturación de la instancia. Valores válidos: Postpaid: pay-as-you-go. Prepaid: suscripción. Serverless: serverless. Este valor solo es compatible con instancias que ejecutan MySQL. Para obtener más información, consulte Descripción general. Nota El sistema genera automáticamente una orden de compra y completa el pago.
ZoneId	String	No	cn-hangzhou-b	El ID de zona de la instancia principal. Nota Si especifica una virtual private cloud (VPC) y un vSwitch, debe establecer este parámetro en el ID de la zona a la que pertenece el vSwitch especificado. De lo contrario, no se podrá crear la instancia. Si la instancia ejecuta RDS High-availability Edition, debe especificar el parámetro ZoneIdSlave1, que determina si se utiliza el método de despliegue de zona única o el de zonas múltiples. Si la instancia ejecuta RDS Enterprise Edition, debe especificar los parámetros ZoneIdSlave1 y ZoneIdSlave2, que determinan si se utiliza el método de despliegue de zona única o el de zonas múltiples.
ZoneIdSlave1	String	No	cn-hangzhou-c	El ID de zona de la instancia secundaria. Si establece el parámetro ZoneIdSlave1 en el mismo valor que el parámetro ZoneId, se utiliza el método de despliegue de zona única. Si establece el parámetro ZoneIdSlave1 en un valor diferente al del parámetro ZoneId, se utiliza el método de despliegue de zonas múltiples.
ZoneIdSlave2	String	No	cn-hangzhou-d	El ID de zona de la instancia de registro. Si establece el parámetro ZoneIdSlave2 en el mismo valor que el parámetro ZoneId, se utiliza el método de despliegue de zona única. Si establece el parámetro ZoneIdSlave2 en un valor diferente al del parámetro ZoneId, se utiliza el método de despliegue de zonas múltiples.
InstanceNetworkType	String	No	Classic	El tipo de red de la instancia. Valores válidos: VPC. Classic: red clásica. Este es el valor predeterminado. Nota Si la instancia ejecuta MySQL y utiliza SSD estándar o ESSD, debe establecer este parámetro en VPC. Si la instancia ejecuta PostgreSQL o MariaDB, debe establecer este parámetro en VPC. Si la instancia ejecuta SQL Server Basic o SQL Server Web, puede establecer este parámetro en VPC o Classic. Si la instancia ejecuta otros motores de base de datos, debe establecer este parámetro en VPC.
ConnectionMode	String	No	Standard	El modo de conexión de la instancia. Valores válidos: Standard: modo estándar Safe: modo de proxy de base de datos El sistema asigna automáticamente un modo de conexión a la instancia. Nota SQL Server 2012, SQL Server 2016 y SQL Server 2017 solo admiten el modo estándar.
VPCId	String	No	vpc-*****	El ID de la VPC. Nota Si establece el parámetro InstanceNetworkType en VPC, también debe especificar este parámetro.
VSwitchId	String	No	vsw-*****	El ID del vSwitch. El vSwitch debe pertenecer a la zona especificada por el parámetro ZoneId. Nota Si establece el parámetro InstanceNetworkType en VPC, también debe especificar este parámetro. Si especifica el parámetro ZoneSlaveId1, debe especificar los ID de dos vSwitch para este parámetro y separarlos con una coma (,).
PrivateIpAddress	String	No	172.16.XX.XX	La dirección IP privada de la instancia. La dirección IP privada debe estar dentro del bloque CIDR compatible con el vSwitch especificado. ApsaraDB RDS asigna automáticamente una dirección IP privada a la instancia según los valores de los parámetros VPCId y vSwitchId.
UsedTime	String	No	2	La duración de la suscripción de la instancia. Valores válidos: Si establece el parámetro Period en Year, el valor del parámetro UsedTime oscila entre 1 y 5. Si establece el parámetro Period en Month, el valor del parámetro UsedTime oscila entre 1 y 11. Nota Si establece el parámetro PayType en Prepaid, también debe especificar este parámetro.
Period	String	No	Year	La unidad de la duración de la suscripción. Valores válidos: Year Month Nota Si establece el parámetro PayType en Prepaid, también debe especificar este parámetro.
ResourceGroupId	String	No	rg-acfmy*****	El ID del resource group al que pertenece la instancia.
DBInstanceStorageType	String	Sí	cloud_essd	El tipo de almacenamiento de la instancia. Valores válidos: local_ssd: SSD local. Este es el tipo de almacenamiento recomendado. cloud_ssd: SSD estándar. No se recomienda este tipo de almacenamiento. Las SSD estándar ya no están disponibles para su compra en algunas regiones de Alibaba Cloud. cloud_essd: ESSD de nivel de rendimiento 1 (PL1). cloud_essd2: ESSD de PL2. cloud_essd3: ESSD de PL3. Nota El valor predeterminado de este parámetro depende del tipo de instancia especificado por el parámetro DBInstanceClass. Si el tipo de instancia especifica el tipo de almacenamiento SSD local, el valor predeterminado de este parámetro es local_ssd. Si el tipo de instancia especifica el tipo de almacenamiento SSD estándar o ESSD, el valor predeterminado de este parámetro es cloud_essd.
BusinessInfo	String	No	121436975448952	Información comercial adicional sobre la instancia.
EncryptionKey	String	No	0d24*****-da7b-4786-b981-9a164dxxxxxx	El ID de la clave que se utiliza para el cifrado de disco en la región donde reside la instancia. Si especifica el parámetro EncryptionKey, el cifrado de disco se habilita automáticamente. En este caso, también debe especificar el parámetro RoleARN. El cifrado de disco no se puede deshabilitar una vez habilitado. Puede obtener el ID de la clave desde la consola de Key Management Service (KMS). También puede crear una clave. Para obtener más información, consulte Crear una CMK.
RoleARN	String	No	acs:ram::1406xxxxxx:role/aliyunrdsinstanceencryptiondefaultrole	El Alibaba Cloud Resource Name (ARN) proporcionado por su cuenta de Alibaba Cloud para usuarios de RAM. Los usuarios de RAM pueden usar el ARN para conectar ApsaraDB RDS a KMS. Puede llamar a la operación CheckCloudResourceAuthorized para consultar el ARN.
AutoRenew	String	No	true	Especifica si se debe habilitar la función de renovación automática para la instancia. Debe especificar este parámetro solo cuando la instancia utiliza el método de facturación por suscripción. Valores válidos: true: habilita la función. false: deshabilita la función. Nota Si establece el parámetro Period en Month, el ciclo de renovación automática es de un mes. Si establece el parámetro Period en Year, el ciclo de renovación automática es de un año.
Category	String	No	HighAvailability	La edición de RDS de la instancia. Valores válidos: Basic: RDS Basic Edition HighAvailability: RDS High-availability Edition AlwaysOn: RDS Cluster Edition para SQL Server Finance: RDS Enterprise Edition serverless_basic: RDS Serverless Basic Edition Nota Si desea crear una instancia serverless, debe utilizar este valor.
DedicatedHostGroupId	String	No	dhg-4n*****	El ID del clúster dedicado al que pertenece la instancia. Si crea la instancia en un clúster dedicado, debe especificar este parámetro. Nota Puede llamar a la operación DescribeDedicatedHostGroups para consultar los detalles de un clúster dedicado. Si no se han creado clústeres dedicados, puede llamar a la operación CreateDedicatedHostGroup para crear un clúster dedicado.
TargetDedicatedHostIdForMaster	String	No	i-bp*****1	El ID del host al que pertenece la instancia en el clúster dedicado. Si crea la instancia en un clúster dedicado, debe especificar este parámetro. Si no especifica este parámetro, el sistema asigna automáticamente un host. Nota Puede llamar a la operación DescribeDedicatedHost para consultar los detalles de los hosts en un clúster dedicado. Si no se han creado hosts, puede llamar a la operación CreateDedicatedHost para crear un host.
TargetDedicatedHostIdForSlave	String	No	i-bp*****2	El ID del host al que pertenece la instancia secundaria en el clúster dedicado. Si la instancia ejecuta RDS High-availability Edition o RDS Enterprise Edition y usted crea la instancia en un clúster dedicado, debe especificar este parámetro. Si no especifica este parámetro, el sistema asigna automáticamente un host. Nota Puede llamar a la operación DescribeDedicatedHosts para consultar los detalles de los hosts en un clúster dedicado. Si no se han creado hosts, puede llamar a la operación CreateDedicatedHost para crear un host.
TargetDedicatedHostIdForLog	String	No	i-bp*****3	El ID del host al que pertenece la instancia de registro en el clúster dedicado. Si la instancia ejecuta RDS Enterprise Edition y usted crea la instancia en un clúster dedicado, debe especificar este parámetro. Si no especifica este parámetro, el sistema asigna automáticamente un host. Nota Puede llamar a la operación DescribeDedicatedHosts para consultar los detalles de los hosts en un clúster dedicado. Si no se han creado hosts, puede llamar a la operación CreateDedicatedHost para crear un host.
DBParamGroupId	String	No	rpg-sys-*****	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. Nota Si desea crear una instancia que ejecute RDS Basic Edition y utilice el motor de almacenamiento X-Engine, debe llamar a la operación anterior, ubicar el campo mysql_xengine_8.0_basic_normal_safe en la respuesta, encontrar el ID de la plantilla de parámetros del sistema requerida y luego usar ese ID como valor para este parámetro. Si desea crear una instancia que ejecute RDS High-availability Edition y utilice el motor de almacenamiento X-Engine, debe llamar a la operación anterior, ubicar el campo mysql_xengine_8.0_standard_normal_safe en la respuesta, encontrar el ID de la plantilla de parámetros del sistema requerida y luego usar ese ID como valor para este parámetro.
DBTimeZone	String	No	+08:00	La zona horaria de la instancia. Este parámetro solo surte efecto cuando establece el parámetro Engine en MySQL o PostgreSQL. Si establece el parámetro Engine en MySQL: La zona horaria de la instancia está en UTC. Valores válidos: de -12:59 a +13:00. Si la instancia utiliza SSD locales, puede especificar el nombre de la zona horaria. Por ejemplo, puede especificar la zona horaria Asia/Hong_Kong. Para obtener más información, consulte Zonas horarias. Si establece el parámetro Engine en PostgreSQL: La zona horaria de la instancia no está en UTC. Para obtener más información, consulte Zonas horarias. Solo puede especificar este parámetro cuando la instancia ejecuta PostgreSQL con SSD estándar o ESSD. Nota Si la instancia es una instancia principal, puede especificar este parámetro. Si la instancia es de solo lectura, no puede especificar este parámetro. Una instancia de solo lectura hereda la zona horaria de su instancia principal. Si no especifica este parámetro, el sistema asigna automáticamente la zona horaria predeterminada de la región donde reside la instancia.
DBIsIgnoreCase	String	No	true	Especifica si el nombre de la tabla distingue entre mayúsculas y minúsculas. Valores válidos: true: Los nombres de tabla no distinguen entre mayúsculas y minúsculas. Este es el valor predeterminado. false: Los nombres de tabla distinguen entre mayúsculas y minúsculas.
TargetMinorVersion	String	No	rds_20200229	La versión menor del motor de la instancia. Este parámetro solo es obligatorio cuando crea una instancia que ejecuta MySQL o PostgreSQL. El formato del valor varía según el motor de base de datos de la instancia. Si crea una instancia de ApsaraDB RDS for MySQL, el valor tiene el siguiente formato: `<RDS edition>_<Minor engine version>`. Ejemplos: `rds_20200229`, `xcluster_20200229` y `xcluster80_20200229`. La siguiente lista describe los campos en los valores de ejemplo: rds: La instancia ejecuta RDS Basic Edition o High-availability Edition. xcluster: La instancia ejecuta MySQL 5.7 en RDS Enterprise Edition. xcluster80: La instancia ejecuta MySQL 8.0 en RDS Enterprise Edition. Nota Puede llamar a la operación DescribeDBMiniEngineVersions para consultar la versión menor del motor. Para obtener más información sobre las versiones menores del motor, consulte Notas de la versión de AliSQL. Si crea una instancia de ApsaraDB RDS for PostgreSQL, el valor tiene el siguiente formato: `rds_postgres_<Major engine version>00_<Minor engine version>`. Ejemplo: `rds_postgres_1400_20220830`. La siguiente lista describe los campos en el valor de ejemplo: 1400: La versión principal del motor es PostgreSQL 14. 20220830: la versión de AliPG. Puede llamar a la operación DescribeDBMiniEngineVersions para consultar la versión de AliPG. Para obtener más información sobre las versiones menores del motor, consulte Notas de la versión de AliPG. Nota Si configura el parámetro BabelfishConfig para su instancia de ApsaraDB RDS for PostgreSQL y establece el campo babelfishEnabled en true, el valor de este parámetro tiene el siguiente formato: `rds_postgres_Major engine version00_AliPG version_babelfish`.
StorageAutoScale	String	No	Disable	Especifica si se debe habilitar la función de expansión automática de almacenamiento para la instancia. Valores válidos: Enable. Disable. Este es el valor predeterminado. Nota Después de crear la instancia, puede llamar a la operación ModifyDasInstanceConfig para modificar la configuración de la función de expansión automática de almacenamiento de la instancia. Para obtener más información, consulte Configurar la expansión automática de almacenamiento para una instancia de ApsaraDB RDS for MySQL.
StorageThreshold	Integer	No	50	El umbral porcentual que activa la expansión automática de almacenamiento. 10 20 30 40 50 Nota Si establece el parámetro StorageAutoScale en Enable, también debe especificar este parámetro.
StorageUpperBound	Integer	No	2000	La capacidad máxima de almacenamiento permitida para la expansión automática de almacenamiento. La capacidad de almacenamiento de la instancia no puede exceder la capacidad máxima de almacenamiento. Unidad: GB. Valores válidos: un número entero mayor o igual a 0. Si establece el parámetro StorageAutoScale en Enable, también debe especificar este parámetro.
DryRun	Boolean	No	false	Especifica si se debe realizar una prueba en seco. Valores válidos: true: realiza una prueba en seco. El sistema comprueba elementos como los parámetros de la solicitud, el formato de la solicitud, los límites del servicio y los recursos disponibles. false: realiza una prueba en seco y envía la solicitud. Si la solicitud pasa la prueba en seco, se ejecuta la operación. Este es el valor predeterminado.
UserBackupId	String	No	67798*****	El ID del archivo de copia de seguridad. Puede llamar a la operación ListUserBackupFiles para consultar archivos de copia de seguridad. Si desea crear una instancia utilizando los datos de un archivo de copia de seguridad, debe especificar este parámetro. Nota Este parámetro solo es compatible cuando se cumplen los siguientes requisitos: El parámetro PayType está establecido en Postpaid. El parámetro Engine está establecido en MySQL. El parámetro EngineVersion está establecido en 5.7. El parámetro Category está establecido en Basic.
Amount	Integer	No	2	El número de instancias de ApsaraDB RDS for MySQL que desea crear. El parámetro solo surte efecto cuando crea varias instancias de ApsaraDB RDS for MySQL simultáneamente mediante una sola solicitud. Valores válidos: de 1 a 20. Valor predeterminado: 1. Nota Si desea crear varias instancias de ApsaraDB RDS for MySQL simultáneamente mediante una sola solicitud, puede agregar etiquetas a todas las instancias utilizando el parámetro Tag.N.Key y el parámetro Tag.N.Value. Después de crear las instancias, puede gestionarlas según las etiquetas. Después de enviar una solicitud para crear varias instancias de ApsaraDB RDS for MySQL, esta operación devuelve los parámetros TaskId, RequestId y Message. Puede llamar a la operación DescribeDBInstanceAttribute para consultar los detalles de una instancia. Si el valor del parámetro Engine no es MySQL y el valor del parámetro Amount es mayor que 1, esta operación falla y devuelve un código de error `InvalidParam.Engine`.
CreateStrategy	String	No	Atomicity	La política según la cual se crean varias instancias. El parámetro solo surte efecto cuando el valor del parámetro Amount es mayor que 1. Valores válidos: Atomicity: atomicidad. Se crean todas las instancias. Si no se puede crear una instancia, no se crea ninguna. Partial: no atómica. Cada instancia se crea de forma independiente. El fallo en la creación de una instancia no afecta la creación de las demás. Nota Valor predeterminado: Atomicity.
Tag.N.Key	String	No	testkey1	La clave de la etiqueta N que desea agregar a la instancia. Puede usar este parámetro para agregar etiquetas a la instancia. Nota Si la clave de etiqueta especificada ya existe, el sistema agrega directamente la clave a la instancia. Puede llamar a la operación ListTagResources para consultar los detalles de las etiquetas existentes. Si la clave de etiqueta especificada no existe, el sistema crea la clave y la agrega a la instancia. El valor de este parámetro no puede ser una cadena vacía. Este parámetro debe usarse junto con el parámetro Tag.N.Value.
Tag.N.Value	String	No	testvalue1	El valor de la etiqueta N que se agrega a la instancia. Puede usar este parámetro para agregar etiquetas a la instancia. Nota Si el valor de etiqueta especificado se encuentra en la clave de etiqueta especificada, el sistema agrega directamente el valor a la instancia. Puede llamar a la operación ListTagResources para consultar los detalles de las etiquetas existentes. Si el valor de etiqueta especificado no se encuentra en la clave de etiqueta especificada, el sistema crea el valor y lo agrega a la instancia. Este parámetro debe usarse junto con el parámetro Tag.N.Key.
DeletionProtection	Boolean	No	true	Especifica si se debe habilitar la función de protección contra liberación para la instancia. true: habilita la función. false: deshabilita la función. Este es el valor predeterminado.
BabelfishConfig	String	No	{"babelfishEnabled":"true","migrationMode":"single-db","masterUsername":"babelfish_user","masterUserPassword":"Babelfish123!"}	La configuración de la función Babelfish para la instancia de ApsaraDB RDS for PostgreSQL. Formato:{"babelfishEnabled":"true","migrationMode":"xxxxxxx","masterUsername":"xxxxxxx","masterUserPassword":"xxxxxxxx"} La siguiente lista describe los campos en el formato: babelfishEnabled: especifica si se debe habilitar Babelfish para la instancia. Si establece este campo en true, habilita Babelfish para la instancia. Si deja este parámetro vacío, no habilita Babelfish para la instancia. migrationMode: el modo de migración de la instancia. Valores válidos: single-db y multi-db. masterUsername: el nombre de usuario de la cuenta de administrador. El nombre de usuario puede contener letras minúsculas, dígitos y guiones bajos (_). Debe comenzar con una letra y terminar con una letra o un dígito. Puede tener hasta 63 caracteres de longitud y no puede comenzar con pg. masterUserPassword: la contraseña de la cuenta de administrador. La contraseña debe contener al menos tres de los siguientes tipos de caracteres: letras mayúsculas, letras minúsculas, dígitos y caracteres especiales. Debe tener entre 8 y 32 caracteres de longitud. La contraseña puede contener cualquiera de los siguientes caracteres: `! @ # $ % ^ & * ( ) _ + - =`. Nota Este parámetro solo surte efecto cuando crea una instancia de ApsaraDB RDS for PostgreSQL. Para obtener más información, consulte Introducción a Babelfish.
ServerlessConfig	Object	No		La configuración de la instancia serverless. Este parámetro es obligatorio cuando crea una instancia serverless. Nota Este parámetro solo surte efecto cuando crea una instancia de ApsaraDB RDS for MySQL.
MaxCapacity	double	No	8	El número máximo de RDS Capacity Units (RCU). Valores válidos: 0.5 a 8. Nota El valor de este parámetro debe ser mayor o igual al valor del parámetro MinCapacity.
MinCapacity	double	No	0.5	El número mínimo de RCU. Valores válidos: 0.5 a 8. Nota El valor de este parámetro debe ser menor o igual al valor del parámetro MaxCapacity.
AutoPause	Boolean	No	true	Especifica si se debe habilitar la función de inicio y detención inteligente para la instancia serverless. Valores válidos: true: habilita la función. false: deshabilita la función. Este es el valor predeterminado. Nota Una vez habilitada la función de inicio y detención inteligente, si no se establecen conexiones a la instancia en 10 minutos, la instancia se detiene. Cuando se establece una conexión a la instancia, esta se reactiva automáticamente.
SwitchForce	Boolean	No	false	Especifica si se debe habilitar la función de escalado forzado para la instancia serverless. Valores válidos: true: habilita la función. false: deshabilita la función. Este es el valor predeterminado. Nota Si establece este parámetro en true, ocurre una conexión transitoria que dura aproximadamente 1 minuto durante el proceso de escalado forzado. Proceda con precaución. El escalado de RCU para una instancia serverless surte efecto inmediatamente. En algunos casos, como la ejecución de transacciones grandes, el escalado no surte efecto de inmediato. En este caso, puede habilitar esta función para escalar forzosamente las RCU de la instancia.
ConnectionString	String	No	rm-uf6wjk5*****.mysql.rds.aliyuncs.com	El endpoint de la instancia. Nota El parámetro DBInstanceNetType especifica si el endpoint es interno o público.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
DryRunResult	Boolean	true	Indica si la solicitud pasó la prueba en seco. Valores válidos: true: La solicitud pasó la prueba en seco. false: La solicitud no pasó la prueba en seco. Nota Si el sistema no realiza una prueba en seco, no se devuelve este parámetro. Si la solicitud no pasa la prueba en seco, se devuelve un mensaje de error.
TagResult	Boolean	true	Indica si la etiqueta especificada se agregó a la instancia. Valores válidos: true: La etiqueta especificada se agregó a la instancia. false: No se pudo agregar la etiqueta especificada a la instancia. Nota Si no agrega una etiqueta a la instancia, no se devuelve este parámetro.
RequestId	String	1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC	El ID de la solicitud.
ConnectionString	String	rm-uf6wjk5*****.mysql.rds.aliyuncs.com	El endpoint de la instancia. Nota El parámetro DBInstanceNetType especifica si el endpoint es interno o público.
Message	String	Batch Create DBInstance Task Is In Process.	El mensaje que indica si se crearon varias instancias. Nota Este parámetro se devuelve solo cuando el valor del parámetro Amount es mayor que 1.
DBInstanceId	String	rm-uf6wjk5*****	El ID de la instancia. Si el valor del parámetro Amount es mayor que 1, se devuelve más de un ID de instancia. El número de ID de instancia devueltos es igual al valor del parámetro Amount. Los ID de instancia devueltos están separados por comas (,). Por ejemplo, si el valor del parámetro Amount es 3, se devuelven tres ID de instancia. Ejemplos: `rm-uf6wjk5***1,rm-uf6wjk5*2,rm-uf6wjk5***3`
Port	String	3306	El puerto de la instancia. Nota El parámetro DBInstanceNetType especifica si el puerto es interno o público.
TaskId	String	s2365879-a9d0-55af-fgae-f2*****	El ID de la tarea que se ejecuta para crear varias instancias. Nota Este parámetro se devuelve solo cuando el valor del parámetro Amount es mayor que 1. El parámetro TaskID no se puede utilizar para consultar una tarea.
DryRun	Boolean	true	Indica que el sistema realizó una prueba en seco. Nota El valor devuelto es fijo: true. Si el sistema no realiza una prueba en seco, no se devuelve este parámetro.
OrderId	String	1007893702*****	El ID de la orden.

Nota

En la versión más reciente del SDK, el periodo de tiempo de espera predeterminado en el lado del cliente es diferente al de la instancia. Si utiliza la versión más reciente del SDK para llamar a esta operación, podría reportarse un tiempo de espera agotado incluso si la operación se llama correctamente. Para evitar este problema, establezca el parámetro ReadTimeout en 20000 antes de llamar a esta operación.

Configure the setReadTimeout parameter

Ejemplos

Solicitudes de ejemplo

http(s)://rds.aliyuncs.com/?Action=CreateDBInstance
&RegionId=cn-hangzhou
&Engine=MySQL
&EngineVersion=5.6
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=100
&DBInstanceNetType=Internet
&PayType=Postpaid
&SecurityIPList=10.23.XX.XX/24
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<CreateDBInstanceResponse>
    <OrderId>1007893702*****</OrderId>
    <ConnectionString>rm-uf6wjk5*****.mysql.rds.aliyuncs.com</ConnectionString>
    <DBInstanceId>rm-uf6wjk5*****</DBInstanceId>
    <Port>3306</Port>
    <RequestId>1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC</RequestId>
</CreateDBInstanceResponse>

Formato JSON

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

{
  "OrderId" : "1007893702*****",
  "ConnectionString" : "rm-uf6wjk5*****.mysql.rds.aliyuncs.com",
  "DBInstanceId" : "rm-uf6wjk5*****",
  "Port" : 3306,
  "RequestId" : "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidInstanceLevel.DiskType	Specified instance level not support request disk type	El mensaje de error devuelto porque el tipo de instancia especificado no admite el tipo de almacenamiento solicitado.
400	RR309	We have detected a security risk with your payment method. Please proceed with verification via the link in your email or console message and re-submit your order after verification.	El mensaje de error devuelto porque se detectaron riesgos de seguridad en su método de pago. Haga clic en el enlace del correo electrónico que se le envió o en la consola de ApsaraDB RDS para continuar con la verificación. Después de completar la verificación, envíe la orden nuevamente.
400	InvalidZoneId.NotSupported	The Specified vpc Zone not supported.	El mensaje de error devuelto porque la zona especificada no permite crear una instancia en una VPC. Especifique una zona diferente e inténtelo de nuevo.
400	InvalidZone.NotSupportedForStorageType	The specified zone is closed or invalid for Specified DBInstanceStorageType.	El mensaje de error devuelto porque la zona especificada ya no está disponible o el parámetro DBInstanceStorageType especificado no es válido.
400	InvalidZone.NotSupported	The Specified Zone not supported.	El mensaje de error devuelto porque el ID de región especificado no es válido.
400	InvalidEssdStorageSize	invalid cloud essd storage size.	El mensaje de error devuelto porque el tipo de instancia especificado no es válido. Seleccione un tipo de instancia válido e inténtelo de nuevo.
400	IncompleteAccountInfo	Your information is incomplete. Complete your information before the operation.	El mensaje de error devuelto porque la información de su cuenta está incompleta. Inicie sesión en la consola Account Center y especifique todos los elementos de información de la cuenta marcados con un asterisco (*). Compruebe los elementos de información en la página Basic Information.
400	IncompleteTaxInfo	Your tax information is incomplete. Complete your information before the operation.	El mensaje de error devuelto porque su información fiscal está incompleta. Especifique toda la información fiscal obligatoria.
400	InvalidPaymentMethod.Incomplete	No payment method is specified for your account. We recommend that you add a payment method.	El mensaje de error devuelto porque no se proporcionó un método de pago válido en su cuenta de Alibaba Cloud. Agregue un método de pago válido e inténtelo de nuevo.
400	InvalidPaymentMethod.Missing	No payment method is specified for your account. We recommend that you add a payment method.	El mensaje de error devuelto porque no se proporcionó un método de pago válido en su cuenta de Alibaba Cloud. Agregue un método de pago válido e inténtelo de nuevo.
400	InsuffcientBalanceOrBankAccount	Add a payment method or add funds to the prepayment balance. Get started by creating an instance.	El mensaje de error devuelto porque no se proporcionó un método de pago válido en la cuenta actual de Alibaba Cloud. Agregue un método de pago válido o agregue fondos a la cuenta actual de Alibaba Cloud.
400	VswitchIpExhausted	Vswitch IP exhausted.	El mensaje de error devuelto porque las direcciones IP del vSwitch se han agotado.
400	InvalidPrivateIpAddress.AlreadyUsed	The specified IP is already used.	El mensaje de error devuelto porque la dirección IP especificada ya está en uso.
400	InvalidConcurrentOperate	Concurrent operation is detected.	El mensaje de error devuelto porque se están ejecutando operaciones concurrentes en el sistema. Espere a que finalice la operación anterior e inténtelo de nuevo.
400	ZoneId.NotMatchWithCategory	The number of ZoneId specified does not match with category.	El mensaje de error devuelto porque el número de zonas que especificó no es compatible con el motor de base de datos o la edición de RDS especificados. Especifique un número válido de zonas e inténtelo de nuevo.
400	InvalidSecurityIPList.Format	The specified parameter securityIPList is not valid.	El mensaje de error devuelto porque la lista blanca de direcciones IP especificada tiene un formato no válido. Modifique la lista blanca de direcciones IP e inténtelo de nuevo.
400	InvalidEngineVersion.Malformed	The specified parameter EngineVersion is not valid.	El mensaje de error devuelto porque la versión del motor de base de datos especificada no es válida. Compruebe la versión del motor de base de datos e inténtelo de nuevo.
400	CreditPayInsufficientBalance	Insufficient credit pay limit. Please contact your channel partner to increase the limit.	El mensaje de error devuelto porque su cuenta de Alibaba Cloud no tiene saldo suficiente. Asegúrese de que el saldo de su cuenta de Alibaba Cloud sea suficiente.
400	InvalidTagKey.Malformed	The Tag.N.Key parameter is empty.	El mensaje de error devuelto porque el parámetro Tag.N.Key está vacío.
400	InvalidTagValue.Malformed	The Tag.N.Value parameter is empty.	El mensaje de error devuelto porque el parámetro Tag.N.Value está vacío.
400	Duplicate.TagKey	The Tag.N.Key contains duplicate keys.	El mensaje de error devuelto porque el parámetro Tag.N.Key especifica una clave duplicada.
400	NumberExceed.Tags	The maximum number of Tags is exceeded. The maximum is 20.	El mensaje de error devuelto porque el número de etiquetas que especificó excede el máximo permitido. Se permite un máximo de 20 etiquetas.
400	MissingParameter.ResourceIds	The parameter ResourceIds.N must not be null.	El mensaje de error devuelto porque el parámetro ResourceIds.N está vacío.
400	InvalidParameter.TagKey	The Tag.N.Key parameter is invalid.	El mensaje de error devuelto porque el valor del parámetro Tag.N.Key no es válido.
400	InvalidParameter.TagValue	The Tag.N.Value parameter is invalid.	El mensaje de error devuelto porque el valor del parámetro Tag.N.Value no es válido.
400	NoPermission.SystemTag	You have no permission to use system tags.	El mensaje de error devuelto porque las etiquetas que especificó son etiquetas del sistema.
400	InvalidParam.Amount	Amount is allowed from 1 to 20.	El mensaje de error devuelto porque el valor del parámetro Amount no está dentro del rango de 1 a 20.
400	InvalidParam.CreateStrategy	Only Atomicity and Partial are allowed.	El mensaje de error devuelto porque el valor del parámetro CreateStrategy no es Atomicity ni Partial.
400	InvalidConnectionString.Duplicate	Specified connection string already exists in the Aliyun RDS.	El mensaje de error devuelto porque el endpoint que especificó ya existe. Especifique un endpoint diferente.
401	CannotDecreaseEssdPerfLevel	cannot decrease cloud essd performance level.	El mensaje de error devuelto porque el cambio de tipo de almacenamiento no pasó la verificación. Una instancia que ejecuta SQL Server con SSD estándar o ESSD solo se puede actualizar para usar SSD estándar o ESSD con las nuevas especificaciones.
403	AliCroup2CloudUserCannotBuyNotInnerCommodity	There is no group cloud commodity label, and users within the group are not allowed to purchase.	El mensaje de error devuelto porque los productos no tienen la etiqueta de Alibaba Cloud y no están disponibles para usuarios internos.
403	GroupReplicationNotSupport.InvalidEngineVersion	Group Replication requires the instance engine version to be 8.0.	El mensaje de error devuelto porque la versión principal del motor de la instancia no es MySQL 8.0 y no se admite la replicación de grupo.
403	GroupReplicationNotSupport.InvalidNodeClassCode	Group Replication requires the ClassCode of each node to be consistent.	El mensaje de error devuelto porque las especificaciones de los nodos en la instancia son diferentes y no se admite la replicación de grupo.
403	GroupReplicationNotSupport.InvalidNodeNum	Group Replication is not supported, the number of nodes must be an odd number greater than or equal to 3.	El mensaje de error devuelto porque el número de nodos en la instancia no es un número impar mayor o igual a 3 y no se admite la replicación de grupo.
403	GroupReplicationNotSupport.InvalidXengine	Group Replication is not supported because the instance has xengine tables.	El mensaje de error devuelto porque existen tablas X-Engine en la instancia y no se admite la replicación de grupo.
403	GroupReplicationNotSupport.MemoryTooSmall	Group Replication is not supported because the memory is too small.	El mensaje de error devuelto porque la capacidad de memoria de la instancia es pequeña y no se admite la replicación de grupo de MySQL.
403	IncorrectMinorVersion	Current engine minor version does not support operations.	El mensaje de error devuelto porque esta operación no es compatible con la versión menor actual del motor.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.