Tüm Ürünler
Search
Belge Merkezi

:CreateDBInstance

Son Güncelleme:Oct 14, 2026

Bir ApsaraDB for SelectDB örneği oluşturur.

Operation description

Abonelik örnekleri silinemez.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

selectdb:CreateDBInstance

create

*Tüm kaynaklar.

*

None None

Request parameters

Parameter

Type

Required

Description

Example

ResourceGroupId

string

No

Kaynak grubu kimliği.

rg-aekzt2zaluvuvqa_fake

ClientToken

string

No

İsteğin idempotent olmasını sağlamak ve yinelenen gönderimleri önlemek için kullanılan istemci belirteci. Değeri oluşturmak için istemciyi kullanabilirsiniz, ancak farklı istekler arasında benzersiz olduğundan emin olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz.

AB

Engine

string

No

Veritabanı motoru türü. Varsayılan değer: selectdb.

selectdb

EngineVersion

string

Yes

Veritabanı motoru sürümü. Varsayılan değer: 4.1. Geçerli değerler:

  • 4.0

  • 4.1

4.1

ChargeType

string

Yes

Örneğin faturalandırma yöntemi. Geçerli değerler:

  • Postpaid: Kullandıkça öde.

  • Prepaid: Abonelik.

PrePaid

UsedTime

integer

No

Abonelik örneğinin abonelik süresi. Birim, Period parametresi tarafından belirlenir. Year yılı, Month ise ayı ifade eder. Geçerli değerler:

  • Period değeri Year olarak ayarlandığında, UsedTime için geçerli değerler 1, 2, 3, 4 ve 5'tir.

  • Period değeri Month olarak ayarlandığında, UsedTime için geçerli değerler 1 ile 12 arasındadır.

Not

Bu parametre yalnızca ChargeType değeri Prepaid olarak ayarlandığında geçerli olur ve zorunludur.

1

Period

string

No

Abonelik kümesinin abonelik dönemi birimi. Geçerli değerler:

  • Year: Yıllık abonelik.

  • Month: Aylık abonelik.

Not

Bu parametre yalnızca ChargeType değeri Prepaid olarak ayarlandığında geçerli olur ve zorunludur.

Month

DBInstanceClass

string

Yes

Örnek türü. Örnek türlerini sorgulamak için DescribeAllDBInstanceClass işlemini çağırabilirsiniz.

selectdb.g.2xlarge

RegionId

string

Yes

Bölge kimliği.

cn-hangzhou

ZoneId

string

Yes

Bölge kimliği.

cn-hangzhou-e

CacheSize

integer

Yes

Ayrılmış önbellek boyutu.

200

VpcId

string

Yes

VPC kimliği.

vpc-bp175iuvg8nxqraf2****

VSwitchId

string

Yes

vSwitch kimliği.

vsw-bp1gzt31twhlo0sa5****

DBInstanceDescription

string

No

Örneğin açıklaması.

Test new instance

ConnectionString

string

No

Veritabanı uç noktası.

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

SecurityIPList

string

No

Örneğin IP adresi beyaz listesi. Birden fazla IP adresini virgül (,) ile ayırın.

192.168.1.1

Tag

array<object>

No

Örnek etiket listesi bilgileri.

object

No

Örnek etiket listesi.

Key

string

No

Etiket anahtarı.

testKey

Value

string

No

Etiket değeri.

testValue

DeployScheme

string

No

Örneğin dağıtım modu.

Valid values:

  • multi_az :

    Bölge yedekli.

  • single_az :

    Yerel olarak yedekli.

single_az

MultiZone

array<object>

No

Çoklu bölge yapılandırması.

Not
  • Bu parametre, DeployScheme değeri multi_az olarak ayarlandığında geçerli olur ve zorunludur.

object

No

Bölge listesi.

VSwitchIds

array

No

vSwitch kimlikleri listesi.

string

No

vSwitch kimliği.

vsw-bp10dbralpn4bzmgkkh8f

ZoneId

string

No

Bölge kimliği.

cn-hangzhou-k

AddVPCIPs

string

No

VPC CIDR bloğunun beyaz listeye eklenip eklenmeyeceğini belirtir. Geçerli değerler:

  • 1: evet

  • 0: hayır

Valid values:

  • 0 :

    no.

  • 1 :

    evet.

1

ClusterNodeType

string

No

Küme düğümü türü. Bu parametre yalnızca Serverless modunda geçerlidir.

ClusterNodeCount

integer

No

Küme düğümlerinin sayısı. Bu parametre yalnızca Serverless modunda geçerlidir.

1

ScaleMax

number

No

Örnek RCU (RDS Capacity Unit) otomatik ölçeklendirme aralığının maksimum değeri.

32

ScaleMin

number

No

Örnek RCU (RDS Capacity Unit) otomatik ölçeklendirme aralığının minimum değeri.

4

ConfigPatternType

string

No

Örneğe uygulanan yapılandırma şablonu.

FEClassCode

string

No

Tek bir FE kümesi düğümünün düğüm teknik özellikleri. Bu parametre yalnızca kullandıkça öde veya abonelik örneği oluşturduğunuzda geçerlidir. Varsayılan değer: selectdb_fe.xlarge16.

selectdb_fe.xlarge16

FENodeCount

string

No

FE kümesi düğümlerinin sayısı. Bu parametre yalnızca kullandıkça öde veya abonelik örneği oluşturduğunuzda geçerlidir. Varsayılan değer: 3. Geçerli değerler: 1 ile 11 arası. Değer tek sayı olmalıdır.

3

Response elements

Element

Type

Description

Example

object

Yanıt şeması.

Data

object

Döndürülen sonuç.

DBInstanceId

string

Örnek kimliği.

selectdb-cn-7213cjv****

OrderId

integer

Sipariş kimliği.

21137950671****

RequestId

string

İstek kimliği.

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

Examples

Success response

JSON format

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

Error codes

HTTP status code

Error code

Error message

Description

400 COMMODITY.INVALID_COMPONENT Order configuration parameters do not meet the verification conditions, please re-match the product. Sipariş yapılandırma parametreleri doğrulama gereksinimlerini karşılamaz. Ürünü yeniden yapılandırın.
400 DocumentConvertFailed.ExceedFileSizeLimit The conversion has been failed, exceed file size limit. Dosya boyutu sistem sınırını aştığı için belge dönüştürme işlemi başarısız oldu.
400 Forbidden User not authorized to operate on the specified resource, or this API does not support RAM. RAM kullanıcısı gerekli izinlere sahip değil. Önce yetkilendirme alın.
400 InvalidDBName The specified database name is not allowed. Veritabanı adı gereksinimleri karşılamıyor. Veritabanı adının doğru olup olmadığını kontrol edin.
400 CreateOrderFailed Failed to create order. Sipariş oluşturma işlemi başarısız oldu.
400 InvalidVSwitchId.Malformed The specified parameter "VSwitchId" is not valid. VSwitchId parametresi geçersiz.
400 InvalidMultiZone.NotThreeZones The number of zones must be three. Bölge sayısı üç olmalıdır.
400 InvalidZoneId.Duplicated The zones cannot be repeated please select different zones. Seçilen bölgeler benzersiz olmalıdır.
400 EngineVersionDoNotSupportMultiZone The specified engine version doesn't support multi zone. Belirtilen sürüm çoklu bölge dağıtım modunu desteklemez.
400 InvalidChargeType.Malformed The specified parameter "ChargeType" is not valid. ChargeType parametresi geçersiz.
400 InvalidBuyConfigCpuOrCacheSize The specified purchase configuration CPU or cache size is invalid. Satın alma yapılandırmasında belirtilen CPU veya önbellek boyutu geçersiz.
400 InvalidZoneId.Malformed The specified parameter "ZoneId" is not valid. ZoneId parametresi geçersiz.
400 InvalidVpcId.Malformed The specified parameter "VpcId" is not valid. VpcId parametresi geçersiz.
400 ORDER.INST_HAS_UNPAID_ORDER Instance has unpaid order. Örneğin ödenmemiş siparişleri bulunmaktadır.
400 OperationDenied.OrderProcessing There are orders in process. Bir sipariş işleniyor.
400 InvalidInstanceClass.MultiAZ The instance with 4-core BE cluster does not support multi-zone redundancy. 4 CPU'ya sahip BE kümeleri, bölge afet kurtarma için çoklu bölge dağıtımını desteklemez.
400 InvalidFEClassCode.Blank The specified parameter "FEClassCode" is blank. FEClassCode istek parametresi boş.
400 InvalidFENodeCount The specified parameter "FENodeCount" is not valid. FENodeCount parametresi geçersiz.
400 InvalidFENodeCount.Blank The specified parameter "FENodeCount" is blank. FENodeCount istek parametresi boş.
400 InvalidInstanceClass.ForMultiAZ The instance with 4-core BE cluster does not support upgrading to multi-zone redundancy. 4 CPU'ya sahip BE kümeleri, bölge afet kurtarma için çoklu bölge dağıtımını desteklemez.
400 InvalidFENodeCount.ForMultiAZ The instance with FENodeCount that less than 3 does not support upgrading to multi-zone redundancy. Bölge afet kurtarma örneğindeki FE düğümü sayısı 3'ten büyük veya ona eşit olmalıdır.
400 InvalidDBClusterClass.SeriesNotSupport Current class code is no longer available for creating instances, please use the standard series class code (e.g. selectdb.g.2xlarge). Mevcut teknik özellik, örnek oluşturmak için desteklenmiyor. Geçerli teknik özellikleri almak için DescribeAllDBInstanceClass işlemini çağırın.
403 DBClusterNotSupported The requested operation can not be performed while the cluster is not sale. Küme çalışmadığı için istenen işlem gerçekleştirilemez.
403 IncorrectDBInstanceState Current DB instance state does not support this operation. Mevcut örnek durumu bu işlemi desteklemez.
403 InstanceEngineType.NotSupport The instance engine and type does not support operations. Örnek motoru ve türü bu işlemi desteklemediği için işlem başarısız oldu.
403 InvalidDBInstanceState.NotSupport The specified instance state does't support this operation. Belirtilen örnek durumu bu işlemi desteklemiyor.
403 MoneyLessThan100 The Account Monet less Than 100. Mevcut Alibaba Cloud hesabının bakiyesi 100'den az. Hesabınıza bakiye yükleyin.
403 OperationDenied.DBNameAndAccountPrivilegeCount The operation is not permitted due to count of database or account privilege. Veritabanı sayısı ile izin sayısı eşleşmediği için işlem başarısız oldu.
403 InsufficientResourceCapacity The resource is out of usage. Kaynaklar yetersiz. Daha sonra tekrar deneyin.
403 INSUFFICIENT_AVAILABLE_QUOTA Your account available limit is less than 0, please recharge before trying to purchase. Hesabınızın kullanılabilir kredisi 0'dan az. Hesabınıza bakiye yükleyin ve tekrar satın almayı deneyin.
403 OperationDenied.SpecificClassCodeNotSupported The uid is not in specific classcode whitelist. Seçilen teknik özellikler mevcut hesapta kullanılamaz.
404 DBInstanceLocked The current instance lock mode does not support this operation. Mevcut örnek kilitli olduğu için işlem başarısız oldu.
404 IncorrectVswitchId The specified parameter VSwitchId is not valid. vSwitch parametresi geçersiz.
404 InvalidApi.NotFound Specified api is not found, please check your url and method.
404 InvalidDBInstance.NotFound The specified instance is not found. Belirtilen örnek bulunamadı. Örnek kimliğinin doğru olup olmadığını kontrol edin.
404 InvalidDBInstanceClass.NotFound The specified instance classic does not exist. Seçilen yapılandırma veya teknik özellik mevcut değil ya da artık kullanılamıyor. Farklı bir yapılandırma veya teknik özellik seçin.
404 InvalidRegionId.NotFound The provided RegionId does not exist in our records. Belirtilen bölge ve kullanılabilirlik bölgesi mevcut olmadığı için işlem başarısız oldu.
404 QueryPrice.Failed The inquiry failed. Contact Alibaba Cloud customer service representatives. Fiyat sorgulaması başarısız oldu. Müşteri hizmetleriyle iletişime geçin.
404 InvalidVSwitch.NoIP VSwitch has zero available IP. vSwitch'te kullanılabilir IP adresı yok.
404 InvalidDBClusterClass.NotFound The specified cluster class does not exist. Belirtilen küme teknik özellikleri mevcut değil.
404 InvalidVPC.NotFound VPC or VSwitch is not valid. VPC veya vSwitch geçersiz.
404 InvalidFEClass.NotFound The specified fe class doesn't exist. FE kümesi teknik özelliği mevcut değil.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.