DescribePrice介面中DBInstances參數的詳細說明 -

本文對DescribePrice介面中的DBInstances參數進行詳細說明。該介面用於查詢建立ApsaraDB for MongoDB執行個體、升級配置或續約操作產生的費用。

參數說明

參數名稱	類型	是否必須	說明	樣本
DBInstanceId	String	否	執行個體ID。您可以通過調用DescribeDBInstances介面查詢執行個體列表。說明當訂單類型為變更配置或續約執行個體時，需要配置該參數。	dds-bp13bbf2407f****
RegionId	String	是	地區ID。您可以通過調用DescribeRegions介面查詢地區ID。	cn-hangzhou
ZoneId	String	否	可用性區域ID。您可以通過調用DescribeRegions介面查詢可用性區域ID。	cn-hangzhou-h
Engine	String	是	資料庫類型。固定為MongoDB。	MongoDB
EngineVersion	String	是	資料庫版本。取值： 3.4 4.0 4.2 4.4 5.0 6.0 7.0	4.2
DBInstanceClass	String	否	複本集執行個體規格。不同執行個體類型的執行個體規格詳情，請參見執行個體規格表。說明當查詢建立ApsaraDB for MongoDB執行個體的費用時，需要配置該參數，例如新購或複製執行個體等情境。	dds.mongo.mid
DBInstanceStorage	String	否	儲存空間。單位：GB。說明當時執行個體為複本集執行個體時，該參數必填。	20
ReplicationFactor	String	否	節點數。取值為1、3、5、7。說明僅適用複本集執行個體。	3
NetworkType	String	否	網路類型。取值： VPC：專用網路。	VPC
VpcId	String	否	專用網路的ID。	vpc-bp1q2qqm4vxo6e6zl****
VSwitchId	String	否	虛擬交換器的ID。	vsw-bp1lb40helio22b6d****
ChargeType	String	是	付費類型。取值： PostPaid：隨用隨付。 PrePaid：訂用帳戶。	PostPaid
AutoPay	String	否	自動付費。取值： True：是。 False：否。	True
pricingCycle	String	否	訂用帳戶執行個體付費時間長度的單位，取值如下： Month：月。 Year：年。說明當付費類型為訂用帳戶時，需要配置該參數。該參數僅支援複本集執行個體。	Month
Period	String	否	訂用帳戶的購買時間長度，取值為大於1的整數，取值單位說明如下：分區叢集執行個體：單位為月。複本集執行個體：單位為pricingCycle參數設定的值。說明當付費類型為訂用帳戶時，需要配置該參數。	1
configServers	JSON	否	分區叢集ConfigServer節點的規格。包含如下參數： nodeClass：ConfigServer節點的規格，固定為1核 2 GB（通用型）。 nodeStorage：ConfigServer節點的儲存容量，預設為20 GB。	`[{"nodeClass":"dds.cs.mid","nodeStorage":"20"}]`
mongos	JSON	否	分區叢集Mongos節點的規格。包含如下參數： nodeClass：Mongos節點的規格。 Mongos節點支援的規格資訊，請參見執行個體規格表。	`[{"nodeClass":"dds.mongos.mid"},{"nodeClass":"dds.mongos.mid"}]`
shards	JSON	否	分區叢集Shard節點的規格。包含如下參數： nodeClass：Shard節點的規格。 nodeStorage：Shard節點的儲存容量，最小值為10，單位為GB。說明如果需要傳入shards參數，則nodeStorage必填。 ReadonlyReplicas：唯讀節點的數量。取值為0~5的整數。 Shard節點支援的規格資訊，請參見執行個體規格表。	`[{"nodeClass":"dds.shard.mid","ReadonlyReplicas":"1","nodeStorage":"10"},{"nodeClass":"dds.shard.mid","ReadonlyReplicas":"1","nodeStorage":"10"}]`
ReadonlyReplicas	String	否	唯讀節點的數量，取值為0~5的整數。說明該參數僅適用於複本集執行個體。	1
StorageType	String	是	執行個體的儲存類型，取值： local_ssd：SSD本地碟。 cloud_essd1：ESSD PL1雲端硬碟。 cloud_essd2：ESSD PL2雲端硬碟。 cloud_essd3：ESSD PL3雲端硬碟。說明 ApsaraDB for MongoDB 4.2及以下版本支援SSD本地碟。 ApsaraDB for MongoDB 4.4及以上版本支援ESSD PL1雲端硬碟、ESSD PL2雲端硬碟和ESSD PL3雲端硬碟。	cloud_essd1
ProvisionedIops	String	否	預配置效能（IOPS），取值範圍為 0~50000。僅當StorageType參數值為cloud_auto時使用。	0

樣本

新購分區叢集執行個體

本樣本為新購訂用帳戶的分區叢集執行個體。

[
    {
        "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"
    }
]

分區叢集執行個體變更配置

本樣本為訂用帳戶的分區叢集執行個體變更配置Mongos節點。

[
    {
        "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"
            }
        ]
    }
]

新購複本集執行個體

本樣本為新購訂用帳戶複本集執行個體。

[
    {
        "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"
    }
]

複本集執行個體變更配置

本樣本為隨用隨付複本集執行個體變更配置。

[
    {
        "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"
    }
]