Détails du paramètre DBInstances dans l'opération DescribePrice -

Cette rubrique décrit les sous-paramètres du paramètre DBInstances utilisé dans l'opération DescribePrice et fournit des exemples. Appelez l'opération DescribePrice pour connaître les frais liés à la création, à la mise à niveau ou au renouvellement d'une instance ApsaraDB for MongoDB.

Sous-paramètres

Sous-paramètre	Type	Obligatoire	Description	Exemple
DBInstanceId	String	Non	ID de l'instance. Appelez l'opération DescribeDBInstances pour obtenir la liste des instances. Remarque Ce paramètre est obligatoire si le type de commande correspond à un changement de configuration ou à un renouvellement d'instance.	dds-bp13bbf2407f****
RegionId	String	Oui	ID de la région de l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.	cn-hangzhou
ZoneId	String	Non	ID de la zone de l'instance. Appelez l'opération DescribeRegions pour obtenir les ID de zone.	cn-hangzhou-h
Engine	String	Oui	Moteur de base de données. Définissez la valeur sur MongoDB.	MongoDB
EngineVersion	String	Oui	Version du moteur de base de données de l'instance. Valeurs possibles : 3.4 4.0 4.2 4.4 5.0 6.0 7.0	4.2
DBInstanceClass	String	Non	Type d'instance de l'instance de réplica. Pour plus d'informations, consultez la page Types d'instances. Remarque Ce paramètre est obligatoire pour consulter les frais de création d'instances (achat ou clonage).	dds.mongo.mid
DBInstanceStorage	String	Non	Capacité de stockage de l'instance. Unité : Go. Remarque Ce paramètre est obligatoire pour les instances de réplica.	20
ReplicationFactor	String	Non	Nombre de nœuds dans l'instance. Valeurs possibles : 1, 3, 5 et 7. Remarque Ce paramètre concerne uniquement les instances de réplica.	3
NetworkType	String	Non	Type de réseau de l'instance. Valeur possible : VPC : Virtual Private Cloud (VPC)	VPC
VpcId	String	Non	ID du VPC.	vpc-bp1q2qqm4vxo6e6zl****
VSwitchId	String	Non	ID du vSwitch.	vsw-bp1lb40helio22b6d****
ChargeType	String	Oui	Mode de facturation de l'instance. Valeurs possibles : PostPaid : paiement à l'utilisation PrePaid : abonnement	PostPaid
AutoPay	String	Non	Indique s'il faut activer le renouvellement automatique de l'instance. Valeurs possibles : True : active le renouvellement automatique de l'instance. False : désactive le renouvellement automatique de l'instance.	True
pricingCycle	String	Non	Unité de la période d'abonnement de l'instance. Valeurs possibles : Month Year Remarque Ce paramètre est obligatoire si le mode de facturation de l'instance est l'abonnement. Ce paramètre concerne uniquement les instances de réplica.	Month
Period	String	Non	Période d'abonnement de l'instance. La valeur doit être un entier supérieur à 1. L'unité de période est déterminée selon les règles suivantes : Si l'instance est un cluster fragmenté, l'unité de période est le mois. Si l'instance est une instance de réplica, l'unité de période correspond à la valeur du paramètre pricingCycle. Remarque Ce paramètre est obligatoire si le mode de facturation de l'instance est l'abonnement.	1
configServers	JSON	Non	Spécifications du nœud Configserver dans le cluster fragmenté. Les sous-paramètres suivants sont inclus : nodeClass : type d'instance du nœud Configserver. Définissez la valeur sur 1 cœur, 2 Go (usage général). nodeStorage : capacité de stockage du nœud Configserver. Définissez la valeur sur 20 Go.	`[{"nodeClass":"dds.cs.mid","nodeStorage":"20"}]`
mongos	JSON	Non	Spécifications du nœud mongos dans le cluster fragmenté. Les sous-paramètres suivants sont inclus : nodeClass : type d'instance du nœud mongos. Pour plus d'informations, consultez la page Types d'instances.	`[{"nodeClass":"dds.mongos.mid"},{"nodeClass":"dds.mongos.mid"}]`
shards	JSON	Non	Spécifications du nœud shard. Les sous-paramètres suivants sont inclus : nodeClass : type d'instance du nœud shard. nodeStorage : capacité de stockage du nœud shard. Valeur minimale : 10. Unité : Go. Remarque Si vous spécifiez le paramètre shards, le paramètre nodeStorage est obligatoire. ReadonlyReplicas : nombre de nœuds en lecture seule. Valeurs possibles : 0, 1, 2, 3, 4 et 5. Pour plus d'informations, consultez la page Types d'instances.	`[{"nodeClass":"dds.shard.mid","ReadonlyReplicas":"1","nodeStorage":"10"},{"nodeClass":"dds.shard.mid","ReadonlyReplicas":"1","nodeStorage":"10"}]`
ReadonlyReplicas	String	Non	Nombre de nœuds en lecture seule. Valeurs possibles : 0, 1, 2, 3, 4 et 5. Remarque Ce paramètre concerne uniquement les instances de réplica.	1
StorageType	String	Oui	Type de stockage de l'instance. Valeurs possibles : local_ssd : SSD local cloud_essd1 : ESSD PL1 (Enhanced SSD) cloud_essd2 : ESSD PL2 cloud_essd3 : ESSD PL3 Remarque Les instances ApsaraDB for MongoDB exécutant MongoDB 4.2 ou une version antérieure prennent en charge les SSD locaux. Les instances ApsaraDB for MongoDB exécutant MongoDB 4.4 ou une version ultérieure prennent en charge les disques ESSD PL1, PL2 et PL3.	cloud_essd1
ProvisionedIops	String	Non	IOPS provisionnés de l'instance. Valeurs possibles : 0 à 50000. Ce paramètre est valide uniquement si le paramètre StorageType est défini sur cloud_auto.	0

Exemples

Acheter une instance en cluster fragmenté

L'exemple suivant montre comment acheter une instance en cluster fragmenté avec facturation par abonnement :

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

Modifier la configuration d'une instance en cluster fragmenté

L'exemple suivant montre comment modifier la configuration d'un nœud mongos dans une instance en cluster fragmenté avec facturation par abonnement :

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

Acheter une instance de réplica

L'exemple suivant montre comment acheter une instance de réplica avec facturation par abonnement :

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

Modifier la configuration d'une instance de réplica

L'exemple suivant montre comment modifier la configuration d'une instance de réplica avec facturation par paiement à l'utilisation :

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