All Products
Search

This Product

    ApsaraDB for MongoDB:CreateDBInstance

    Document Center

    ApsaraDB for MongoDB:CreateDBInstance

    Last Updated:Jun 10, 2026

    Membuat atau mengkloning instans replica set Database Apsara for MongoDB.

    Deskripsi operasi

    Before you call this operation, make sure that you understand the billing methods and pricing of ApsaraDB for MongoDB.

    For more information about the instance types of ApsaraDB for MongoDB, see Instance types.

    To create a sharded cluster instance, call the CreateShardingDBInstance operation.

    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

    *Instance

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah. Untuk mengkueri ID wilayah, panggil operasi DescribeRegions.

    Catatan

    Ketika Anda mengkloning instans atau memulihkan instans dari keranjang daur ulang, parameter ini harus sama dengan ID wilayah instans sumber.

    cn-hangzhou
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token. Pastikan token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan tidak boleh lebih dari 64 karakter.

    ETnLKlblzczshOTUbOCz****
    ZoneId

    string

    No

    ID zona. Untuk mengkueri ID zona, panggil operasi DescribeRegions.

    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

    Ketika Anda mengkloning instans atau memulihkan instans dari keranjang daur ulang, parameter ini harus sama dengan versi mesin instans sumber.

    Peringatan

    Versi 3.4 dan sebelumnya telah dihentikan.

    .

    4.4
    DBInstanceClass

    string

    Yes

    Tipe instans. Untuk mengkueri tipe instans, panggil operasi DescribeAvailableResource.

    dds.mongo.standard
    DBInstanceStorage

    integer

    Yes

    Ruang penyimpanan instans dalam format GB.

    Nilai parameter ini bervariasi berdasarkan tipe instans. Untuk informasi selengkapnya, lihat Tipe instans replica set.

    10
    DBInstanceDescription

    string

    No

    Nama instans. Nama harus memenuhi persyaratan berikut:

    • Harus dimulai dengan huruf atau karakter Tionghoa.

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

    • Harus terdiri dari 2 hingga 256 karakter periode.

    test
    SecurityIPList

    string

    No

    Daftar putih alamat IP instans. Pisahkan beberapa alamat IP dengan koma (,). Setiap alamat IP dalam daftar putih harus unik. Daftar putih dapat dalam salah satu format berikut:

    • 0.0.0.0/0

    • Alamat IP, misalnya, 10.23.12.24.

    • Blok CIDR, misalnya, 10.23.12.0/24. /24 menunjukkan bahwa awalan blok CIDR memiliki panjang 24 bit. Anda dapat mengatur awalan ke nilai dari 1 hingga 32.

    Catatan

    • Anda dapat menambahkan maksimum 1.000 alamat IP atau blok CIDR ke semua daftar putih alamat IP.

    • Jika Anda mengatur daftar putih ke 0.0.0.0/0, semua alamat IP dapat mengakses instans. Pengaturan ini berisiko tinggi. Gunakan dengan hati-hati.

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

    string

    No

    Kata sandi untuk akun root. Kata sandi harus memenuhi format dan persyaratan berikut:

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

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

    • Harus terdiri dari 8 hingga 32 karakter.

    Catatan

    Untuk informasi selengkapnya tentang kegagalan koneksi yang disebabkan oleh karakter khusus dalam kata sandi, lihat Bagaimana cara memperbaiki kegagalan koneksi yang disebabkan oleh karakter khusus dalam kata sandi?.

    123456Aa
    Period

    integer

    No

    Durasi langganan instans dalam bulan.

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

    Catatan

    Parameter ini wajib diisi dan hanya berlaku ketika Anda mengatur parameter ChargeType ke PrePaid.

    1
    ChargeType

    string

    No

    Metode penagihan instans. Nilai valid:

    • PostPaid: Nilai default. Pay-as-you-go.

    • PrePaid: Langganan.

    Catatan

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

    PrePaid
    NetworkType

    string

    No

    Jenis jaringan instans. Nilai valid:

    VPC: virtual private cloud (VPC).

    VPC
    VpcId

    string

    No

    ID VPC.

    vpc-bp175iuvg8nxqraf2****
    VSwitchId

    string

    No

    ID vSwitch.

    vsw-bp1gzt31twhlo0sa5****
    SrcDBInstanceId

    string

    No

    ID instans sumber.

    Catatan

    Ketika Anda mengkloning instans, Anda harus menentukan parameter ini dan parameter BackupId atau RestoreTime. Ketika Anda memulihkan instans dari keranjang daur ulang, Anda hanya perlu menentukan parameter ini. Anda tidak perlu menentukan parameter BackupId atau RestoreTime.

    dds-bp1ee12ad351****
    BackupId

    string

    No

    ID titik cadangan. Untuk mengkueri ID titik cadangan, panggil operasi DescribeBackups.

    Catatan

    Anda harus menentukan parameter ini dan parameter SrcDBInstanceId hanya ketika Anda mengkloning instans berdasarkan titik cadangan.

    32994****
    RestoreTime

    string

    No

    Pengatur waktu yang ingin Anda gunakan untuk memulihkan instans. Anda dapat menentukan pengatur waktu apa pun dalam tujuh hari terakhir. Waktu harus dalam format yyyy-MM-ddTHH:mm:ssZ dan dalam UTC.

    Catatan

    Anda harus menentukan parameter ini dan parameter SrcDBInstanceId hanya ketika Anda mengkloning instans berdasarkan pengatur waktu.

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

    string

    No

    Informasi bisnis dalam format bebas. Parameter ini opsional.

    {“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 opsional dan hanya berlaku ketika Anda mengatur parameter ChargeType ke PrePaid.

    true
    DatabaseNames

    string

    No

    Nama database.

    Catatan

    Ketika Anda mengkloning instans, Anda dapat menentukan parameter ini untuk mengkloning database tertentu. Jika Anda tidak menentukan parameter ini, semua database instans 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. Nilainya tetap dalam format WiredTiger.

    Catatan

    • Ketika Anda mengkloning instans atau memulihkan instans dari keranjang daur ulang, parameter ini harus sama dengan mesin penyimpanan instans sumber.

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

    WiredTiger
    ReplicationFactor

    string

    No

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

    • 3 (default)

    • 5

    • 7

    Penting

    Anda tidak perlu menentukan parameter ini untuk instans standalone.

    .

    3
    ReadonlyReplicas

    string

    No

    Jumlah node hanya-baca dalam instans replica set. Nilai valid adalah bilangan bulat dari 0 hingga 5. Nilai default-nya adalah 0.

    0
    Engine

    string

    No

    Mesin database. Nilainya tetap MongoDB.

    MongoDB
    StorageType

    string

    No

    Kelas penyimpanan. Nilai valid:

    • cloud_essd1: Disk ESSD PL1.

    • cloud_essd2: Disk ESSD PL2.

    • cloud_essd3: Disk ESSD PL3.

    • cloud_auto: Disk ESSD AutoPL.

    • local_ssd: SSD lokal.

    Catatan

    • Untuk instans standalone, jika Anda meneruskan nilai cloud_essd1, disk ESSD akan digunakan.

    • Disk ESSD AutoPL hanya tersedia di situs Tiongkok (aliyun.com).

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

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

    cloud_essd1
    SecondaryZoneId

    string

    No

    Zona tempat node sekunder diterapkan. Parameter ini digunakan untuk penerapan multi-zona. Nilai valid:

    • cn-hangzhou-g: Zona G di Hangzhou.

    • cn-hangzhou-h: Zona H di Hangzhou.

    • cn-hangzhou-i: Zona I di Hangzhou.

    • cn-hongkong-b: Zona B di Hong Kong (Tiongkok).

    • cn-hongkong-c: Zona C di Hong Kong (Tiongkok).

    • cn-hongkong-d: Zona D di Hong Kong (Tiongkok).

    • cn-wulanchabu-a: Zona A di Ulanqab.

    • cn-wulanchabu-b: Zona B di Ulanqab.

    • cn-wulanchabu-c: Zona C di Ulanqab.

    • ap-southeast-1a: Zona A di Singapura.

    • ap-southeast-1b: Zona B di Singapura.

    • ap-southeast-1c: Zona C di Singapura.

    • ap-southeast-5a: Zona A di Jakarta.

    • ap-southeast-5b: Zona B di Jakarta.

    • ap-southeast-5c: Zona C di Jakarta.

    • eu-central-1a: Zona A di Frankfurt.

    • eu-central-1b: Zona B di Frankfurt.

    • eu-central-1c: Zona C di Frankfurt.

    Catatan

    • Parameter ini tersedia ketika instans menggunakan disk.

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

    cn-hangzhou-h
    HiddenZoneId

    string

    No

    Zona tempat node tersembunyi diterapkan. Parameter ini digunakan untuk penerapan multi-zona. Nilai valid:

    • cn-hangzhou-g: Zona G di Hangzhou.

    • cn-hangzhou-h: Zona H di Hangzhou.

    • cn-hangzhou-i: Zona I di Hangzhou.

    • cn-hongkong-b: Zona B di Hong Kong (Tiongkok).

    • cn-hongkong-c: Zona C di Hong Kong (Tiongkok).

    • cn-hongkong-d: Zona D di Hong Kong (Tiongkok).

    • cn-wulanchabu-a: Zona A di Ulanqab.

    • cn-wulanchabu-b: Zona B di Ulanqab.

    • cn-wulanchabu-c: Zona C di Ulanqab.

    • ap-southeast-1a: Zona A di Singapura.

    • ap-southeast-1b: Zona B di Singapura.

    • ap-southeast-1c: Zona C di Singapura.

    • ap-southeast-5a: Zona A di Jakarta.

    • ap-southeast-5b: Zona B di Jakarta.

    • ap-southeast-5c: Zona C di Jakarta.

    • eu-central-1a: Zona A di Frankfurt.

    • eu-central-1b: Zona B di Frankfurt.

    • eu-central-1c: Zona C di Frankfurt.

    Catatan

    • Parameter ini tersedia ketika instans menggunakan disk.

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

    cn-hangzhou-i
    Tag

    array

    No

    Tag kustom.

    GlobalSecurityGroupIds

    string

    No

    Template daftar putih alamat IP global untuk instans. Pisahkan beberapa template dengan koma (,). Template tidak boleh berulang. Fitur ini berada dalam rilis canary.

    g-qxieqf40xjst1ngpr3jz

    Encrypted

    boolean

    No

    Apakah akan mengaktifkan enkripsi disk.

    EncryptionKey

    string

    No

    ID kunci kustom.

    2axxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    ProvisionedIops

    integer

    No

    IOPS yang disediakan (operasi input/output per detik). Nilai valid: 0 hingga 50000.

    1960
    RestoreType

    string

    No

    Metode untuk memulihkan instans dari cadangan.

    • 0: Memulihkan instans ke set cadangan tertentu.

    • 1: Memulihkan instans ke titik pengatur waktu tertentu.

    • 2: Memulihkan instans yang telah dirilis ke set cadangan tertentu.

    • 3: Memulihkan instans ke set cadangan geo-redundan tertentu.

    0
    SrcRegion

    string

    No

    Wilayah tempat instans sumber berada.

    Catatan

    • Parameter ini wajib diisi ketika RestoreType diatur ke 2 atau 3.

    2
    RestoreType

    string

    No

    备份恢复实例。

    • 0: 恢复实例到指定备份集

    • 1: 恢复实例到指定时间点

    • 2: 恢复已释放实例到指定备份集

    • 3: 恢复实例到指定的异地备份集

    0
    SrcRegion

    string

    No

    源实例所在区域。

    Catatan

    • 当备份恢复类型为 2 或 3 时，需要且必填

    2

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

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

    string

    The instance ID.

    dds-bp144a7f2db8****
    OrderId

    string

    The order ID.

    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.
    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.
    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.
    400 SameZoneId The specified primary zone, secondary zone require two different zones.
    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.
    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.