All Products
Search
Document Center

:Rincian parameter DBInstances dalam operasi DescribePrice

Last Updated:Nov 09, 2025

Topik ini menjelaskan subparameter dari parameter DBInstances yang digunakan dalam operasi DescribePrice dan menyediakan contoh. Anda dapat memanggil operasi DescribePrice untuk menanyakan biaya yang timbul saat membuat, meningkatkan, atau memperpanjang instance ApsaraDB for MongoDB.

Subparameter

Subparameter

Tipe

Wajib

Deskripsi

Contoh

DBInstanceId

String

Tidak

ID instance. Anda dapat memanggil operasi DescribeDBInstances untuk menanyakan daftar instance.

Catatan

Parameter ini diperlukan ketika tipe pesanan adalah perubahan konfigurasi atau pembaruan instance.

dds-bp13bbf2407f****

RegionId

String

Ya

ID wilayah instance. Anda dapat memanggil operasi DescribeRegions untuk menanyakan daftar wilayah terbaru.

cn-hangzhou

ZoneId

String

Tidak

ID zona instance. Anda dapat memanggil operasi DescribeRegions untuk menanyakan ID zona.

cn-hangzhou-h

Engine

String

Ya

Mesin database dari database. Atur nilainya menjadi MongoDB.

MongoDB

EngineVersion

String

Ya

Versi mesin database instance. Nilai valid:

  • 3.4

  • 4.0

  • 4.2

  • 4.4

  • 5.0

  • 6.0

  • 7.0

4.2

DBInstanceClass

String

Tidak

Tipe instance dari instance set replika. Untuk informasi lebih lanjut, lihat Tipe instance.

Catatan

Parameter ini diperlukan saat Anda menanyakan biaya untuk membuat instance, seperti pembelian atau kloning instance.

dds.mongo.mid

DBInstanceStorage

String

Tidak

Kapasitas penyimpanan instance. Satuan: GB.

Catatan

Parameter ini diperlukan jika instance adalah instance set replika.

20

ReplicationFactor

String

Tidak

Jumlah node dalam instance. Nilai valid: 1, 3, 5, dan 7.

Catatan

Parameter ini hanya tersedia untuk instance set replika.

3

NetworkType

String

Tidak

Tipe jaringan instance. Nilai valid:

  • VPC: Virtual Private Cloud (VPC)

VPC

VpcId

String

Tidak

ID VPC.

vpc-bp1q2qqm4vxo6e6zl****

VSwitchId

String

Tidak

ID vSwitch.

vsw-bp1lb40helio22b6d****

ChargeType

String

Ya

Metode penagihan instance. Nilai valid:

  • PostPaid: bayar sesuai pemakaian

  • PrePaid: langganan

PostPaid

AutoPay

String

Tidak

Menentukan apakah akan mengaktifkan perpanjangan otomatis untuk instance. Nilai valid:

  • True: mengaktifkan perpanjangan otomatis untuk instance.

  • False: menonaktifkan perpanjangan otomatis untuk instance.

True

pricingCycle

String

Tidak

Satuan periode langganan instance. Nilai valid:

  • Bulan

  • Tahun

Catatan
  • Parameter ini diperlukan ketika metode penagihan instance adalah langganan.

  • Parameter ini hanya tersedia untuk instance set replika.

Bulan

Period

String

Tidak

Periode langganan instance. Nilainya harus bilangan bulat yang lebih besar dari 1. Satuan periode ditentukan berdasarkan aturan berikut:

  • Jika instance adalah instance kluster sharded, satuan periode adalah bulan.

  • Jika instance adalah instance set replika, satuan periode adalah nilai parameter pricingCycle.

Catatan

Parameter ini diperlukan ketika metode penagihan instance adalah langganan.

1

configServers

JSON

Tidak

Spesifikasi node Configserver dalam instance kluster sharded. Subparameter berikut termasuk:

  • nodeClass: tipe instance node Configserver. Atur nilainya menjadi 1 core, 2 GB (general-purpose).

  • nodeStorage: kapasitas penyimpanan node Configserver. Atur nilainya menjadi 20 GB.

[{"nodeClass":"dds.cs.mid","nodeStorage":"20"}]

mongos

JSON

Tidak

Spesifikasi node mongos dalam instance kluster sharded. Subparameter berikut termasuk:

  • nodeClass: tipe instance node mongos.

Untuk informasi lebih lanjut, lihat Tipe instance.

[{"nodeClass":"dds.mongos.mid"},{"nodeClass":"dds.mongos.mid"}]

shards

JSON

Tidak

Spesifikasi node shard. Subparameter berikut termasuk:

  • nodeClass: tipe instance node shard.

  • nodeStorage: kapasitas penyimpanan node shard. Nilai minimum: 10. Satuan: GB.

    Catatan

    Jika Anda perlu menentukan parameter shards, parameter nodeStorage diperlukan.

  • ReadonlyReplicas: jumlah node baca-saja. Nilai valid: 0, 1, 2, 3, 4, dan 5.

Untuk informasi lebih lanjut, lihat Tipe instance.

[{"nodeClass":"dds.shard.mid","ReadonlyReplicas":"1","nodeStorage":"10"},{"nodeClass":"dds.shard.mid","ReadonlyReplicas":"1","nodeStorage":"10"}]

ReadonlyReplicas

String

Tidak

Jumlah node baca-saja. Nilai valid: 0, 1, 2, 3, 4, dan 5.

Catatan

Parameter ini hanya tersedia untuk instance set replika.

1

StorageType

String

Ya

Tipe penyimpanan instance. Nilai valid:

  • local_ssd: SSD lokal

  • cloud_essd1: ESSD PL1

  • cloud_essd2: ESSD PL2

  • cloud_essd3: ESSD PL3

Catatan
  • Instance ApsaraDB for MongoDB yang menjalankan MongoDB 4.2 atau lebih lama mendukung SSD lokal.

  • Instance ApsaraDB for MongoDB yang menjalankan MongoDB 4.4 ke atas mendukung ESSD PL1, ESSD PL2, dan ESSD PL3.

cloud_essd1

ProvisionedIops

String

Tidak

IOPS yang disediakan untuk instance. Nilai valid: 0 hingga 50000.

Parameter ini hanya valid ketika parameter StorageType diatur ke cloud_auto.

0

Contoh

Membeli instance kluster sharded

Contoh berikut menunjukkan cara membeli instance kluster sharded dengan metode penagihan langganan:

[
    {
        "period": 24,
        "EngineVersion": "7.0",
        "StorageType": "cloud_essd1",
        "ZoneId": "cn-hangzhou-i",
        "chargeType": "PrePaid",
        "configServers": [
            {
                "nodeClass": "mdb.shard.2x.xlarge.d",
                "nodeStorage": "20"
            }
        ],
        "mongos": [
            {
                "nodeClass": "mdb.shard.2x.xlarge.d"
            },
            {
                "nodeClass": "mdb.shard.2x.xlarge.d"
            }
        ],
        "shards": [
            {
                "shard_ordernum": "1",
                "nodeClass": "mdb.shard.2x.xlarge.d",
                "ReadonlyReplicas": "0",
                "nodeStorage": "20"
            }
        ],
        "NetworkType": "VPC",
        "RegionId": "cn-hangzhou",
        "Engine": "MongoDB"
    }
]

Mengubah konfigurasi instance kluster sharded

Contoh berikut menunjukkan cara mengubah konfigurasi node mongos dalam instance kluster sharded dengan metode penagihan langganan:

[
    {
        "DBInstanceId": "dds-2zeefc0eb52a****",
        "StorageType": "cloud_essd1",
        "RegionId": "cn-beijing",
        "ZoneId": "cn-beijing-h",
        "Engine": "MongoDB",
        "EngineVersion": "4.4",
        "NetworkType": "VPC",
        "ChargeType": "PrePaid",
        "mongos": [
            {
                "nodeClass": "mdb.shard.2x.xlarge.d"
            }
        ]
    }
]

Membeli instance set replika

Contoh berikut menunjukkan cara membeli instance set replika dengan metode penagihan langganan:

[
    {
        "period": 1,
        "EngineVersion": "7.0",
        "StorageType": "cloud_essd1",
        "ZoneId": "cn-hangzhou-i",
        "ReplicationFactor": "3",
        "ReadonlyReplicas": "0",
        "DBInstanceClass": "mdb.shard.2x.xlarge.d",
        "chargeType": "PrePaid",
        "NetworkType": "VPC",
        "DBInstanceStorage": "20",
        "pricingCycle": "Month",
        "RegionId": "cn-hangzhou",
        "Engine": "MongoDB"
    }
]

Mengubah konfigurasi instance set replika

Contoh berikut menunjukkan cara mengubah konfigurasi instance set replika dengan metode penagihan bayar sesuai pemakaian:

[
    {
        "StorageType": "cloud_essd1",
        "EngineVersion": "5.0",
        "ReplicationFactor": "3",
        "ZoneId": "cn-hangzhou-h",
        "ReadonlyReplicas": "1",
        "DBInstanceClass": "mdb.shard.2x.2xlarge.d",
        "chargeType": "PostPaid",
        "ProvisionedIops": "0",
        "DBInstanceId": "dds-bp13053cfa2a****",
        "NetworkType": "VPC",
        "DBInstanceStorage": "20",
        "RegionId": "cn-hangzhou",
        "Engine": "MongoDB"
    }
]