Todos los productos
Search
Centro de documentos

ApsaraDB for SelectDB:CreateDBInstance

Última actualización: Sep 01, 2026

Crea una instancia de ApsaraDB for SelectDB.

Descripción de la operación

Las instancias de suscripción no se pueden eliminar.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

selectdb:CreateDBInstance

create

*All Resource

*

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

ResourceGroupId

string

No

El ID del grupo de recursos.

rg-aekzt2zaluvuvqa_fake

ClientToken

string

No

El token de cliente que se utiliza para garantizar la idempotencia de la solicitud y evitar el envío repetido de solicitudes. El token lo genera el cliente y debe ser único en diferentes solicitudes. El token puede tener hasta 64 caracteres ASCII de longitud y no puede contener caracteres que no sean ASCII.

AB

Engine

string

No

El tipo de base de datos. Valor predeterminado: selectdb.

selectdb

EngineVersion

string

Sí

La versión del motor de base de datos. Valor predeterminado: 4.1. Descripción de valores válidos:

4.1

ChargeType

string

Sí

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

PrePaid

UsedTime

integer

No

La duración de la suscripción de la instancia. Descripción de valores válidos:

1

Period

string

No

Especifica si el clúster de pago por adelantado se factura de forma anual o mensual. Descripción de valores válidos:

Month

DBInstanceClass

string

Sí

Las especificaciones de la instancia. Puede llamar a la operación DescribeAllDBInstanceClass para consultar las especificaciones de la instancia.

selectdb.xlarge

RegionId

string

Sí

El ID de la región.

cn-hangzhou

ZoneId

string

Sí

El ID de la zona.

cn-hangzhou-e

CacheSize

integer

Sí

El tamaño de caché reservado.

200GB

VpcId

string

Sí

El ID de la VPC.

vpc-bp175iuvg8nxqraf2****

VSwitchId

string

Sí

El ID del vSwitch.

vsw-bp1gzt31twhlo0sa5****

DBInstanceDescription

string

No

La descripción de la instancia.

Prueba de nueva instancia

ConnectionString

string

No

El endpoint de la base de datos.

selectdb-cn-7213c8y****-public.selectdbfe.pre.rds.aliyuncs.com

SecurityIPList

string

No

La lista blanca de IP de la instancia. Separe varias direcciones IP con comas (,).

192.168.1.1

Tag

array<object>

No

La lista de etiquetas de la instancia.

object

No

La lista de etiquetas de la instancia.

Key

string

No

La clave de la etiqueta.

testKey

Value

string

No

El valor de la etiqueta.

testValue

DeployScheme

string

No

El modo de despliegue de la instancia.

single_az

MultiZone

array<object>

No

La configuración multizona.

object

No

La lista de zonas múltiples.

ZoneId

string

No

El ID de la zona.

cn-hangzhou-k

VSwitchIds

array

No

La lista de ID de vSwitch.

string

No

El ID del vSwitch.

vsw-bp10dbralpn4bzmgkkh8f

AddVPCIPs

string

No

Especifica si se debe agregar el bloque CIDR de la VPC a la lista blanca. Descripción de valores válidos:

1

ClusterNodeType

string

No

ClusterNodeCount

integer

No

ScaleMax

number

No

ScaleMin

number

No

ConfigPatternType

string

No

La plantilla de configuración aplicada a la instancia.

FEClassCode

string

No

Las especificaciones de nodo de un solo nodo de clúster FE. Este parámetro solo surte efecto cuando crea una instancia de pago por uso o de suscripción. Valor predeterminado: selectdb_fe.xlarge16.

FENodeCount

string

No

El número de nodos de clúster FE. Este parámetro solo surte efecto cuando crea una instancia de pago por uso o de suscripción. Valor predeterminado: 3. Valores válidos: 1 a 11 (solo números impares).

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Esquema de la respuesta.

RequestId

string

El ID de la solicitud.

4773E4EC-025D-509F-AEA9-D53123FDFB0F

Data

object

El resultado devuelto.

DBInstanceId

string

El ID de la instancia.

selectdb-cn-7213cjv****

OrderId

integer

El ID del pedido.

21137950671****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "4773E4EC-025D-509F-AEA9-D53123FDFB0F",
  "Data": {
    "DBInstanceId": "selectdb-cn-7213cjv****",
    "OrderId": 0
  }
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

400 COMMODITY.INVALID_COMPONENT Order configuration parameters do not meet the verification conditions, please re-match the product. Order configuration parameters do not meet the verification conditions, please re-match the product!
400 DocumentConvertFailed.ExceedFileSizeLimit The conversion has been failed, exceed file size limit. english description1
400 Forbidden User not authorized to operate on the specified resource, or this API does not support RAM. english description1
400 InvalidDBName The specified database name is not allowed. english description1
400 CreateOrderFailed Failed to create order. Failed to create order.
400 InvalidVSwitchId.Malformed The specified parameter "VSwitchId" is not valid. The parameter VSwitchId is invalid.
400 InvalidMultiZone.NotThreeZones The number of zones must be three. The number of multi-availability zones must be three.
400 InvalidZoneId.Duplicated The zones cannot be repeated please select different zones. The selected Availability Zone cannot be duplicated
400 EngineVersionDoNotSupportMultiZone The specified engine version doesn't support multi zone. The specified version does not support the multi_az deploy scheme.
400 InvalidChargeType.Malformed The specified parameter "ChargeType" is not valid. The specified parameter "ChargeType" is not valid.
400 InvalidBuyConfigCpuOrCacheSize The specified purchase configuration CPU or cache size is invalid. The specified purchase configuration CPU or cache size is invalid.
400 InvalidZoneId.Malformed The specified parameter "ZoneId" is not valid. The ZoneId parameter is invalid
400 InvalidVpcId.Malformed The specified parameter "VpcId" is not valid. Invalid VpcId parameter
400 ORDER.INST_HAS_UNPAID_ORDER Instance has unpaid order. The instance has an unpaid order.
400 OperationDenied.OrderProcessing There are orders in process. There are orders in process.
400 InvalidInstanceClass.MultiAZ The instance with 4-core BE cluster does not support multi-zone redundancy. 4-CPU BE clusters do not support multi-zone same-city redundancy.
400 InvalidFEClassCode.Blank The specified parameter "FEClassCode" is blank. The request parameter FEClassCode is empty.
400 InvalidFENodeCount The specified parameter "FENodeCount" is not valid.
400 InvalidFENodeCount.Blank The specified parameter "FENodeCount" is blank. Request parameters
400 InvalidInstanceClass.ForMultiAZ The instance with 4-core BE cluster does not support upgrading to multi-zone redundancy. 4-CPU BE clusters do not support multi-zone same-city redundancy.
400 InvalidFENodeCount.ForMultiAZ The instance with FENodeCount that less than 3 does not support upgrading to multi-zone redundancy. The number of FE nodes of a redundant instance in the same city must be greater than or equal to 3.
403 DBClusterNotSupported The requested operation can not be performed while the cluster is not sale. The requested operation cannot be performed while the cluster is not running.
403 IncorrectDBInstanceState Current DB instance state does not support this operation. english description1
403 InstanceEngineType.NotSupport The instance engine and type does not support operations. english description1
403 InvalidDBInstanceState.NotSupport The specified instance state does't support this operation. The instance is in a state that does not support the current operation.
403 MoneyLessThan100 The Account Monet less Than 100. english description1
403 OperationDenied.DBNameAndAccountPrivilegeCount The operation is not permitted due to count of database or account privilege. english description1
403 InsufficientResourceCapacity The resource is out of usage. Not enough resources, please try again later.
403 INSUFFICIENT_AVAILABLE_QUOTA Your account available limit is less than 0, please recharge before trying to purchase. Your account available limit is less than 0, please recharge before trying to purchase
403 OperationDenied.SpecificClassCodeNotSupported The uid is not in specific classcode whitelist. The selected specification is not open to the current account.
404 DBInstanceLocked The current instance lock mode does not support this operation. english description1
404 IncorrectVswitchId The specified parameter VSwitchId is not valid. english description1
404 InvalidApi.NotFound Specified api is not found, please check your url and method.
404 InvalidDBInstance.NotFound The specified instance is not found. english description1
404 InvalidDBInstanceClass.NotFound The specified instance classic does not exist. english description1
404 InvalidRegionId.NotFound The provided RegionId does not exist in our records. english description1
404 QueryPrice.Failed The inquiry failed. Contact Alibaba Cloud customer service representatives. english description1
404 InvalidVSwitch.NoIP VSwitch has zero available IP. VSwitch has zero available IP.
404 InvalidDBClusterClass.NotFound The specified cluster class does not exist. The specified cluster class does not exist.
404 InvalidVPC.NotFound VPC or VSwitch is not valid. Invalid VPC or VSwitch
404 InvalidFEClass.NotFound The specified fe class doesn't exist. The FE cluster specification does not exist.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.