全部产品
Search

搜索本产品

    ApsaraDB for MongoDB：CreateDBInstance

    文档中心

    ApsaraDB for MongoDB：CreateDBInstance

    更新时间：Jan 26, 2026

    Membuat atau mengkloning instans set replika ApsaraDB for MongoDB.

    Deskripsi operasi

    Sebelum memanggil operasi ini, pastikan Anda memahami metode penagihan dan harga ApsaraDB for MongoDB.

    Untuk informasi selengkapnya tentang tipe instans ApsaraDB for MongoDB, lihat Tipe 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

    *Instance

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

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

    Catatan

    Saat 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 tersebut. 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 menanyakan ID zona, panggil operasi DescribeRegions.

    cn-hangzhou-g
    EngineVersion

    string

    Yes

    Versi mesin database. Nilai yang valid:

    • 8.0

    • 7.0

    • 6.0

    • 5.0

    • 4.4

    • 4.2

    • 4.0

    Catatan

    Saat 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 menanyakan tipe instans, panggil operasi DescribeAvailableResource.

    dds.mongo.standard
    DBInstanceStorage

    integer

    Yes

    storage space instans dalam GB.

    Nilai parameter ini bervariasi tergantung pada tipe instans. Untuk informasi selengkapnya, lihat Tipe instans set replika.

    10
    DBInstanceDescription

    string

    No

    Nama instans. Nama harus memenuhi persyaratan berikut:

    • Harus dimulai dengan huruf atau karakter Tionghoa.

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

    • Panjangnya harus antara 2 hingga 256 karakter.

    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 antara 1 hingga 32.

    Catatan

    • Anda dapat menambahkan maksimal 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. Ini adalah pengaturan 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 persyaratan berikut:

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

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

    • Panjangnya harus antara 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 yang valid: 1 hingga 9 (bilangan bulat), 12, 24, 36, dan 60.

    Catatan

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

    1
    ChargeType

    string

    No

    Metode penagihan instans. Nilai yang valid:

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

    • PrePaid: Subscription.

    Catatan

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

    PrePaid
    NetworkType

    string

    No

    Jenis jaringan instans. Nilai yang 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

    Saat Anda mengkloning instans, Anda harus menentukan parameter ini dan parameter BackupId atau RestoreTime. Saat 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 menanyakan ID titik cadangan, panggil operasi DescribeBackups.

    Catatan

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

    32994****
    RestoreTime

    string

    No

    Titik waktu yang ingin Anda pulihkan untuk instans tersebut. Anda dapat menentukan titik 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 saat Anda mengkloning instans berdasarkan titik waktu tertentu.

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

    string

    No

    Informasi bisnis. Ini adalah parameter opsional.

    {“ActivityId":"000000000"}
    AutoRenew

    string

    No

    Menentukan apakah akan mengaktifkan perpanjangan otomatis untuk instans. Nilai yang valid:

    • true: Mengaktifkan perpanjangan otomatis.

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

    Catatan

    Parameter ini bersifat opsional dan hanya berlaku ketika Anda mengatur parameter ChargeType ke PrePaid.

    true
    DatabaseNames

    string

    No

    Nama database.

    Catatan

    Saat 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

    Menentukan apakah akan menggunakan kupon. Nilai yang 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 sebagai WiredTiger.

    Catatan

    • Saat 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 primary dan secondary dalam instans set replika. Nilai yang valid:

    • 3 (default)

    • 5

    • 7

    Penting

    Anda tidak perlu menentukan parameter ini untuk instans mandiri.

    3
    ReadonlyReplicas

    string

    No

    Jumlah node read-only dalam instans set replika. Nilai yang valid adalah bilangan bulat dari 0 hingga 5. Nilai default adalah 0.

    0
    Engine

    string

    No

    Mesin database. Nilainya tetap sebagai MongoDB.

    MongoDB
    StorageType

    string

    No

    kelas penyimpanan. Nilai yang valid:

    • cloud_essd1: ESSD PL1 disk.

    • cloud_essd2: ESSD PL2 disk.

    • cloud_essd3: ESSD PL3 disk.

    • cloud_auto: ESSD AutoPL disk.

    • local_ssd: Local SSD.

    Catatan

    • Untuk instans mandiri, jika Anda memberikan nilai cloud_essd1, maka disk ESSD akan digunakan.

    • ESSD AutoPL disk hanya tersedia di situs China (aliyun.com).

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

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

    cloud_essd1
    SecondaryZoneId

    string

    No

    Zona tempat node secondary diterapkan. Parameter ini digunakan untuk penerapan multi-zona. Nilai yang 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 (China).

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

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

    • 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 saat 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 yang 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 (China).

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

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

    • 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 saat instans menggunakan disk.

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

    cn-hangzhou-i
    Tag

    array<object>

    No

    tag kustom.

    object

    No

    tag kustom yang ditambahkan ke instans.

    Key

    string

    No

    kunci tag.

    Catatan

    • N menentukan tag ke-N. Misalnya, Tag.1.Key menentukan kunci tag pertama, dan Tag.2.Key menentukan kunci tag kedua.

    testdatabase
    Value

    string

    No

    nilai tag.

    Catatan

    N menentukan tag ke-N. Misalnya, Tag.1.Value menentukan nilai tag pertama, dan Tag.2.Value menentukan nilai tag kedua.

    apitest
    GlobalSecurityGroupIds

    string

    No

    Templat daftar putih alamat IP global untuk instans. Pisahkan beberapa templat dengan koma (,). Templat tidak boleh diulang. Fitur ini sedang dalam rilis canary.

    g-qxieqf40xjst1ngpr3jz

    Encrypted

    boolean

    No

    Menentukan apakah akan mengaktifkan enkripsi disk.

    true
    EncryptionKey

    string

    No

    ID kunci kustom.

    2axxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    ProvisionedIops

    integer

    No

    IOPS yang disediakan (operasi input/output per detik). Nilai yang 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 waktu tertentu.

    • 2: Memulihkan instans yang telah dilepas 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 ditentukan ketika RestoreType diatur ke 2 atau 3.

    2

    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.
    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.