All Products
Search

This Product

    ApsaraDB for SelectDB:CreateDBInstance

    Document Center

    ApsaraDB for SelectDB:CreateDBInstance

    Last Updated:Jun 17, 2026

    Membuat instans Database Apsara for SelectDB.

    Deskripsi operasi

    Instans langganan tidak dapat dihapus.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    selectdb:CreateDBInstance

    create

    *All Resource

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    rg-aekzt2zaluvuvqa_fake
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan dan mencegah pengiriman berulang. Nilai dihasilkan oleh klien, harus unik di berbagai permintaan, dapat memuat maksimal 64 karakter ASCII, dan tidak dapat memuat karakter non-ASCII.

    AB
    Engine

    string

    No

    Jenis database. Nilai default: selectdb.

    selectdb
    EngineVersion

    string

    Yes

    Versi engine database. Nilai default: 4.1. Nilai valid:

    • 4.0.

    • 4.1.

    4.1
    ChargeType

    string

    Yes

    Metode penagihan instans. Nilai valid:

    • Postpaid: bayar sesuai pemakaian.

    • Prepaid: langganan.

    PrePaid
    UsedTime

    integer

    No

    Durasi langganan instans. Nilai valid:

    • Jika Period diatur ke Year, nilai valid UsedTime adalah 1, 2, 3, 4, dan 5.

    • Jika Period diatur ke Month, nilai valid UsedTime adalah 1 hingga 12.

    Catatan

    Parameter ini berlaku dan wajib diisi hanya jika ChargeType diatur ke Prepaid.

    1
    Period

    string

    No

    Unit durasi langganan untuk klaster langganan. Nilai valid:

    • Year: pembayaran di muka tahunan.

    • Month: pembayaran di muka bulanan.

    Catatan

    Parameter ini berlaku dan wajib diisi hanya jika ChargeType diatur ke Prepaid.

    Month
    DBInstanceClass

    string

    Yes

    Spesifikasi instans. Anda dapat memanggil operasi DescribeAllDBInstanceClass untuk mengkueri spesifikasi instans yang tersedia.

    selectdb.xlarge
    RegionId

    string

    Yes

    ID wilayah.

    cn-hangzhou
    ZoneId

    string

    Yes

    ID zona.

    cn-hangzhou-e
    CacheSize

    integer

    Yes

    Ukuran cache yang dicadangkan.

    200GB
    VpcId

    string

    Yes

    ID VPC.

    vpc-bp175iuvg8nxqraf2****
    VSwitchId

    string

    Yes

    ID vSwitch.

    vsw-bp1gzt31twhlo0sa5****
    DBInstanceDescription

    string

    No

    Deskripsi instans.

    Test new instance creation
    ConnectionString

    string

    No

    Titik akhir database.

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

    string

    No

    Daftar putih alamat IP instans. Pisahkan beberapa alamat IP dengan koma (,).

    192.168.1.1
    Tag

    array<object>

    No

    Daftar tag instans.

    object

    No

    Daftar tag instans.

    Key

    string

    No

    Kunci tag.

    testKey
    Value

    string

    No

    Nilai tag.

    testValue
    DeployScheme

    string

    No

    Mode penyebaran instans.

    single_az
    MultiZone

    array<object>

    No

    Konfigurasi multi-zona.

    Catatan

    • Parameter ini berlaku dan wajib diisi ketika DeployScheme diatur ke multi_az.

    object

    No

    Daftar zona.

    ZoneId

    string

    No

    ID zona.

    cn-hangzhou-k
    VSwitchIds

    array

    No

    Daftar ID vSwitch.

    string

    No

    ID vSwitch.

    vsw-bp10dbralpn4bzmgkkh8f
    AddVPCIPs

    string

    No

    Apakah akan menambahkan Blok CIDR VPC ke daftar putih. Nilai valid:

    • 1: ya.

    • 0: tidak.

    1
    ClusterNodeType

    string

    No

    ClusterNodeCount

    integer

    No

    ScaleMax

    number

    No

    ScaleMin

    number

    No

    ConfigPatternType

    string

    No

    Templat konfigurasi yang diterapkan ke instans.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    RequestId

    string

    ID permintaan.

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

    object

    Data yang dikembalikan.

    DBInstanceId

    string

    ID instans.

    selectdb-cn-7213cjv****
    OrderId

    integer

    ID pesanan.

    21137950671****

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    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. 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. The conversion has failed because the file size exceeds the limit.
    400 Forbidden User not authorized to operate on the specified resource, or this API does not support RAM. The user is not authorized to operate on the specified resource, or this API does not support RAM.
    400 InvalidDBName The specified database name is not allowed. The specified database name is not allowed.
    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 集群不支持多可用区同城冗余。
    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. The current DB instance state does not support this operation.
    403 InstanceEngineType.NotSupport The instance engine and type does not support operations. The instance engine and type do not support this operation.
    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. The account balance is less than 100.
    403 OperationDenied.DBNameAndAccountPrivilegeCount The operation is not permitted due to count of database or account privilege. The operation is not permitted due to the count of databases or account privileges.
    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. The current instance lock mode does not support this operation.
    404 IncorrectVswitchId The specified parameter VSwitchId is not valid. The specified parameter VSwitchId is not valid.
    404 InvalidApi.NotFound Specified api is not found, please check your url and method.
    404 InvalidDBInstance.NotFound The specified instance is not found. The specified instance is not found.
    404 InvalidDBInstanceClass.NotFound The specified instance classic does not exist. The specified instance class does not exist.
    404 InvalidRegionId.NotFound The provided RegionId does not exist in our records. The provided RegionId does not exist in our records.
    404 QueryPrice.Failed The inquiry failed. Contact Alibaba Cloud customer service representatives. The inquiry failed. Contact Alibaba Cloud customer service representatives.
    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

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.