All Products
Search

This Product

    ApsaraDB for MongoDB:CreateDBInstance

    Document Center

    ApsaraDB for MongoDB:CreateDBInstance

    Last Updated:Oct 08, 2026

    Membuat atau mengkloning instans replika set Database Apsara for MongoDB.

    Deskripsi operasi

    Sebelum menggunakan operasi ini, pastikan Anda memahami metode penagihan dan harga Database Apsara for MongoDB.

    Untuk informasi tentang spesifikasi instans, lihat Spesifikasi instans.

    Untuk membuat instans kluster sharded, panggil operasi CreateShardingDBInstance.

    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

    dds:CreateDBInstance

    create

    *Instans.

    acs:dds:{#regionId}:{#accountId}:dbinstance/*

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

    Catatan

    Jika Anda memanggil operasi ini untuk mengkloning instans atau memulihkan instans kloning dari keranjang daur ulang, atur parameter ini ke nilai yang sama dengan instans sumber.

    cn-hangzhou
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter.

    ETnLKlblzczshOTUbOCz****
    ZoneId

    string

    No

    ID zona. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID zona.

    cn-hangzhou-g
    EngineVersion

    string

    Yes

    Versi mesin database. Nilai valid:

    • 8.0

    • 7.0

    • 6.0

    • 5.0

    • 4.4

    • 4.2

    • 4.0

    Catatan

    Jika Anda memanggil operasi ini untuk mengkloning instans atau memulihkan instans kloning dari keranjang daur ulang, atur parameter ini ke nilai yang sama dengan instans sumber.

    Peringatan Versi 3.4 dan yang lebih lama tidak lagi tersedia untuk dibeli.

    4.4
    DBInstanceClass

    string

    Yes

    Tipe instans. Anda dapat memanggil operasi DescribeAvailableResource untuk mengkueri tipe instans yang tersedia.

    dds.mongo.standard
    DBInstanceStorage

    integer

    Yes

    Kapasitas penyimpanan instans. Unit: GB.

    Nilai valid bergantung pada tipe instans. Untuk detailnya, lihat Spesifikasi instans replika set.

    10
    DBInstanceDescription

    string

    No

    Nama instans. Nama harus memenuhi persyaratan berikut:

    • Harus dimulai dengan karakter Tionghoa atau huruf.

    • Dapat berisi angka, karakter Tionghoa, huruf, garis bawah (_), titik (.), dan tanda hubung (-).

    • Harus memiliki panjang 2 hingga 256 karakter.

    test
    SecurityIPList

    string

    No

    Daftar putih IP instans. Pisahkan beberapa alamat IP dengan koma (,). Alamat IP duplikat tidak diizinkan. Format berikut didukung:

    • 0.0.0.0/0

    • Format alamat IP, seperti 10.23.12.24.

    • Format Blok CIDR, seperti 10.23.12.0/24. Dalam contoh ini, 24 menunjukkan bahwa awalan Blok CIDR memiliki panjang 24 bit. Panjang awalan berkisar dari 1 hingga 32.

    Catatan

    • Setiap instans mendukung maksimum 1.000 alamat IP atau Blok CIDR di seluruh kelompok daftar putih IP.

    • 0.0.0.0/0 mengizinkan semua alamat IP untuk mengakses database instans. Ini adalah pengaturan berisiko tinggi. Lanjutkan dengan hati-hati.

    192.168.xx.xx,192.168.xx.xx
    AccountPassword

    string

    No

    Kata sandi akun root. Kata sandi harus memenuhi persyaratan berikut:

    • Harus berisi setidaknya tiga dari jenis karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus.

    • Karakter khusus meliputi !@#$%^&*()_+-=.

    • Harus memiliki panjang 8 hingga 32 karakter.

    Catatan

    Untuk informasi tentang kegagalan koneksi database yang disebabkan oleh karakter khusus dalam kata sandi, lihat Bagaimana cara menangani kegagalan koneksi database yang disebabkan oleh karakter khusus dalam string koneksi?.

    123456Aa
    Period

    integer

    No

    Durasi langganan instans. Unit: bulan.

    Nilai valid: 1 hingga 9 (bilangan bulat), 12, 24, 36, dan 60.

    Catatan

    Parameter ini tersedia dan diperlukan ketika ChargeType diatur ke PrePaid.

    1
    ChargeType

    string

    No

    Metode penagihan instans. Nilai valid:

    • PostPaid: nilai default. Bayar sesuai pemakaian.

    • PrePaid: Langganan.

    Catatan

    Jika Anda mengatur parameter ini ke PrePaid, Anda juga harus mengonfigurasi parameter Period.

    Valid values:

    • PostPaid :

      bayar sesuai pemakaian.

    • PrePaid :

      langganan.

    PrePaid
    NetworkType

    string

    No

    Jenis jaringan instans. Nilai valid:

    VPC: Virtual Private Cloud.

    Valid values:

    • VPC :

      Virtual Private Cloud.

    VPC
    VpcId

    string

    No

    ID VPC.

    vpc-bp175iuvg8nxqraf2****
    VSwitchId

    string

    No

    ID vSwitch.

    vsw-bp1gzt31twhlo0sa5****
    SrcDBInstanceId

    string

    No

    ID instans sumber.

    Catatan

    Jika Anda memanggil operasi ini untuk mengkloning instans, Anda harus mengonfigurasi parameter ini bersama dengan parameter BackupId atau RestoreTime. Jika Anda memanggil operasi ini untuk memulihkan instans kloning dari keranjang daur ulang, Anda hanya perlu mengonfigurasi parameter ini. Parameter BackupId dan RestoreTime tidak diperlukan.

    dds-bp1ee12ad351****
    BackupId

    string

    No

    ID cadangan. Anda dapat memanggil operasi DescribeBackups untuk mengkueri ID cadangan.

    Catatan

    Parameter ini hanya diperlukan ketika Anda memanggil operasi ini untuk mengkloning instans dari titik cadangan. Anda juga harus mengonfigurasi parameter SrcDBInstanceId.

    32994****
    RestoreTime

    string

    No

    Pengatur waktu untuk memulihkan instans. Anda dapat menentukan pengatur waktu apa pun dalam 7 hari terakhir. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

    Catatan

    Parameter ini hanya diperlukan ketika Anda memanggil operasi ini untuk mengkloning instans ke pengatur waktu tertentu. Anda juga harus mengonfigurasi parameter SrcDBInstanceId.

    2022-03-13T12:11:14Z
    BusinessInfo

    string

    No

    Informasi tambahan tentang bisnis.

    {“ActivityId":"000000000"}
    AutoRenew

    string

    No

    Apakah akan mengaktifkan perpanjangan otomatis untuk instans. Nilai valid:

    • true: Mengaktifkan perpanjangan otomatis.

    • false: nilai default. Menonaktifkan perpanjangan otomatis. Anda harus memperpanjang instans secara manual.

    Catatan

    Parameter ini tersedia dan opsional ketika ChargeType diatur ke PrePaid.

    true
    DatabaseNames

    string

    No

    Nama database.

    Catatan

    Ketika Anda memanggil operasi ini untuk mengkloning instans, Anda dapat menentukan parameter ini untuk mengkloning database tertentu. Jika Anda tidak menentukan parameter ini, semua database akan dikloning.

    mongodbtest
    CouponNo

    string

    No

    Apakah akan menggunakan kupon. Nilai valid:

    • default atau null (default): menggunakan kupon.

    • youhuiquan_promotion_option_id_for_blank: tidak menggunakan kupon.

    default
    StorageEngine

    string

    No

    Mesin penyimpanan instans. Nilai ditetapkan sebagai WiredTiger.

    Catatan

    • Jika Anda memanggil operasi ini untuk mengkloning instans atau memulihkan instans kloning dari keranjang daur ulang, atur parameter ini ke nilai yang sama dengan instans sumber.

    • Untuk informasi tentang batasan pada mesin penyimpanan dan versi, lihat Versi dan mesin penyimpanan.

    Valid values:

    • WiredTiger :

      Mesin penyimpanan WiredTiger.

    WiredTiger
    ReplicationFactor

    string

    No

    Jumlah node primer dan sekunder dalam instans replika set. Nilai valid:

    • 3 (default)

    • 5

    • 7

    Penting Parameter ini tidak diperlukan untuk instans node tunggal.

    3
    ReadonlyReplicas

    string

    No

    Jumlah node hanya-baca dalam instans replika set. Nilai valid: 0 hingga 5 (bilangan bulat). Nilai default: 0.

    0
    Engine

    string

    No

    ID kelompok sumber daya.

    Valid values:

    • MongoDB :

      Mesin database MongoDB.

    rg-acfmyiu4ekp****
    StorageType

    string

    No

    ID klaster khusus.

    dhg-2x78****
    SecondaryZoneId

    string

    No

    Mesin database. Nilai ditetapkan sebagai MongoDB.

    MongoDB
    HiddenZoneId

    string

    No

    Tipe penyimpanan. Nilai valid:

    • cloud_essd1: PL1 ESSD.

    • cloud_essd2: PL2 ESSD.

    • cloud_essd3: PL3 ESSD.

    • cloud_auto: disk ESSD AutoPL.

    • local_ssd: SSD lokal.

    Catatan

    • Untuk instans node tunggal, jika Anda menentukan cloud_essd1, instans menggunakan disk cloud_essd.

    • Disk ESSD AutoPL saat ini hanya tersedia di situs Tiongkok.

    • Untuk instans Berjalan versi 4.4 atau yang lebih baru, nilai default adalah cloud_essd1.

    • Untuk instans Berjalan versi 4.2 atau yang lebih lama, nilai default adalah local_ssd.

    cloud_essd1
    Tag

    array<object>

    No

    Zona tempat node sekunder diterapkan untuk menerapkan penerapan multi-zona. Nilai valid:

    • cn-hangzhou-g: Hangzhou Zone G.

    • cn-hangzhou-h: Hangzhou Zone H.

    • cn-hangzhou-i: Hangzhou Zone I.

    • cn-hongkong-b: Hong Kong (China) Zone B.

    • cn-hongkong-c: Hong Kong (China) Zone C.

    • cn-hongkong-d: Hong Kong (China) Zone D.

    • cn-wulanchabu-a: Ulanqab Zone A.

    • cn-wulanchabu-b: Ulanqab Zone B.

    • cn-wulanchabu-c: Ulanqab Zone C.

    • ap-southeast-1a: Singapore Zone A.

    • ap-southeast-1b: Singapore Zone B.

    • ap-southeast-1c: Singapore Zone C.

    • ap-southeast-5a: Jakarta Zone A.

    • ap-southeast-5b: Jakarta Zone B.

    • ap-southeast-5c: Jakarta Zone C.

    • eu-central-1a: Frankfurt Zone A.

    • eu-central-1b: Frankfurt Zone B.

    • eu-central-1c: Frankfurt Zone C.

    Catatan

    • Parameter ini tersedia ketika instans menggunakan cloud disk.

    • Nilai parameter ini tidak boleh sama dengan nilai ZoneId dan HiddenZoneId.

    cn-hangzhou-h

    object

    No

    Key

    string

    No

    Kunci tag.

    Catatan

    N menunjukkan nomor tag. Misalnya, Tag.1.Key menunjukkan kunci tag pertama, dan Tag.2.Key menunjukkan kunci tag kedua.

    testdatabase
    Value

    string

    No

    Nilai tag.

    Catatan

    N menunjukkan nomor tag. Misalnya, Tag.1.Value menunjukkan nilai tag pertama, dan Tag.2.Value menunjukkan nilai tag kedua.

    apitest
    GlobalSecurityGroupIds

    string

    No

    Zona tempat node tersembunyi diterapkan untuk menerapkan penerapan multi-zona. Nilai valid:

    • cn-hangzhou-g: Hangzhou Zone G.

    • cn-hangzhou-h: Hangzhou Zone H.

    • cn-hangzhou-i: Hangzhou Zone I.

    • cn-hongkong-b: Hong Kong (China) Zone B.

    • cn-hongkong-c: Hong Kong (China) Zone C.

    • cn-hongkong-d: Hong Kong (China) Zone D.

    • cn-wulanchabu-a: Ulanqab Zone A.

    • cn-wulanchabu-b: Ulanqab Zone B.

    • cn-wulanchabu-c: Ulanqab Zone C.

    • ap-southeast-1a: Singapore Zone A.

    • ap-southeast-1b: Singapore Zone B.

    • ap-southeast-1c: Singapore Zone C.

    • ap-southeast-5a: Jakarta Zone A.

    • ap-southeast-5b: Jakarta Zone B.

    • ap-southeast-5c: Jakarta Zone C.

    • eu-central-1a: Frankfurt Zone A.

    • eu-central-1b: Frankfurt Zone B.

    • eu-central-1c: Frankfurt Zone C.

    Catatan

    • Parameter ini tersedia ketika instans menggunakan cloud disk.

    • Nilai parameter ini tidak boleh sama dengan nilai ZoneId dan SecondaryZoneId.

    cn-hangzhou-i
    Encrypted

    boolean

    No

    Tag yang ditentukan pengguna.

    true
    EncryptionKey

    string

    No

    Template daftar putih IP global untuk instans. Pisahkan beberapa template dengan koma (,). Template duplikat tidak diizinkan. (Fitur ini dalam rilis canary.)

    g-qxieqf40xjst1ngpr3jz

    ProvisionedIops

    integer

    No

    Apakah akan mengaktifkan enkripsi disk.

    true
    RestoreType

    string

    No

    ID kunci kustom.

    2axxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    SrcRegion

    string

    No

    Performa yang disediakan (IOPS). Nilai valid: 0 hingga 50000.

    1960

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    D8F1D721-6439-4257-A89C-F1E8E9C9****
    DBInstanceId

    string

    ID instans.

    dds-bp144a7f2db8****
    OrderId

    string

    ID pesanan.

    21077576248****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "D8F1D721-6439-4257-A89C-F1E8E9C9****",
  "DBInstanceId": "dds-bp144a7f2db8****",
  "OrderId": "21077576248****"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 SecurityRisk.AuthVerification we have detected a risk with your default payment method. An email and notification has been sent to you. Please re-submit your order before after verificaiton.
    400 MissingParameter Period is mandatory for this action.
    400 ORDER.ACCOUNT_INFORMATION_INCOMPLETE Your information is incomplete. Complete your information before ordering.
    400 InvalidClientToken.Malformed Specified parameter ClientToken is not valid.
    400 InvalidDBInstanceDescription.Malformed Specified parameter DBInstanceDescription is not valid. Nama node tidak valid.
    400 InvalidSecurityIPListLength.Malformed The quota of security ip exceeds.
    400 InsufficientBalance Your account does not have enough balance.
    400 QuotaExceed.AfterpayInstance Living afterpay instances quota exceeded.
    400 InvalidCapacity.NotFound The Capacity provided does not exist in our records.
    400 ResourceNotAvailable Resource you requested is not available for finance user.
    400 IdempotentParameterMismatch Request uses a client token in a previous request but is not identical to that request.
    400 InvalidSecurityIPList.Malformed The specified parameter "SecurityIPList" is not valid.
    400 InvalidSecurityIPList.Duplicate The Security IP address is not in the available range or occupied.
    400 InvalidDBInstanceStorage.ValueNotSupported The specified parameter DBInstanceStorage is not valid.
    400 InvalidAccountPassword.Malformed Specified parameter AccountPassword is not valid.
    400 TokenServiceError Duplicate ClientToken request.
    400 Zone.Closed The specified zone is closed.
    400 PRICE.ORIGIN_PRICE_ERROR The origin price error.
    400 NO_AVAILABLE_PAYMENT_METHOD No payment method is specified for your account. We recommend that you add a payment method.
    400 InvalidEcsImage.NotFound Specified ecs image does not exist.
    400 SaleValidateNoSpecificCodeFailed Specified Storage or Version or InstanceClass is invalid. Parameter Storage, Version, atau InstanceClass kosong.
    400 Trade_Not_Support_Async_Pay Trade not support async pay.
    400 InvalidZoneld The specified primary zone, secondary zone and hidden zone cannot be the same. Parameter zona utama, zona sekunder 1, dan zona sekunder 2 tidak boleh sama semua.
    400 SameZoneId The specified primary zone, secondary zone require two different zones. Parameter zona utama dan zona sekunder yang ditentukan harus berbeda.
    403 RealNameAuthenticationError Your account has not passed the real-name authentication yet.
    403 RegionUnauthorized There is no authority to create instance in the specified region.
    403 OperationDenied The resource is out of usage. Sumber daya telah melebihi batas penggunaan.
    403 InvalidEngineVersionInRegion.NotAvailable The EngineVersion in the Region is not available.
    403 InvalidBackupLogStatus Current backup log enable status does not support this operation.
    403 IncorrectBackupSetState Current backup set state does not support operations.
    404 InvalidBackup.NotFound The available backup does not exist in recovery time.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.