Detalhes do parâmetro DBInstances na operação DescribePrice - : Central de Documentação do Alibaba Cloud

Este tópico descreve os subparâmetros do parâmetro DBInstances usado na operação DescribePrice e fornece exemplos. Chame a operação DescribePrice para consultar as taxas geradas ao criar, atualizar ou renovar uma instância do ApsaraDB for MongoDB.

Subparâmetros

Subparâmetro	Tipo	Obrigatório	Descrição	Exemplo
DBInstanceId	String	Não	ID da instância. Chame a operação DescribeDBInstances para consultar a lista de instâncias. Nota Parâmetro obrigatório quando o tipo de pedido é alteração de configuração ou renovação de instância.	dds-bp13bbf2407f****
RegionId	String	Sim	ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
ZoneId	String	Não	ID da zona da instância. Use a operação DescribeRegions para obter os IDs das zonas.	cn-hangzhou-h
Engine	String	Sim	Motor do banco de dados. Defina o valor como MongoDB.	MongoDB
EngineVersion	String	Sim	Versão do motor de banco de dados da instância. Valores válidos: 3,4 4,0 4,2 4,4 5,0 6,0 7,0	4,2
DBInstanceClass	String	Não	Tipo da instância de conjunto de réplicas. Para mais informações, consulte Tipos de instância. Nota Parâmetro obrigatório para consultar taxas de criação de instâncias, como compra ou clonagem.	dds.mongo.mid
DBInstanceStorage	String	Não	Capacidade de armazenamento da instância. Unidade: GB. Nota Obrigatório se a instância for um conjunto de réplicas.	20
ReplicationFactor	String	Não	Número de nós na instância. Valores válidos: 1, 3, 5 e 7. Nota Disponível apenas para instâncias de conjunto de réplicas.	3
NetworkType	String	Não	Tipo de rede da instância. Valor válido: VPC: Virtual Private Cloud (VPC)	VPC
VpcId	String	Não	ID da VPC.	vpc-bp1q2qqm4vxo6e6zl****
VSwitchId	String	Não	ID do vSwitch.	vsw-bp1lb40helio22b6d****
ChargeType	String	Sim	Método de faturamento da instância. Valores válidos: PostPaid: pagamento conforme o uso PrePaid: assinatura	PostPaid
AutoPay	String	Não	Define se a renovação automática está ativada para a instância. Valores válidos: True: ative a renovação automática da instância. False: desativa a renovação automática da instância.	True
pricingCycle	String	Não	Unidade do período de assinatura da instância. Valores válidos: Month Year Nota Parâmetro obrigatório quando o método de faturamento é assinatura. Aplicável somente a instâncias de conjunto de réplicas.	Month
Period	String	Não	Período de assinatura da instância. O valor deve ser um número inteiro maior que 1. A unidade do período segue estas regras: Para instâncias de cluster sharded, a unidade é meses. Para instâncias de conjunto de réplicas, a unidade corresponde ao valor do parâmetro pricingCycle. Nota Obrigatório quando o método de faturamento da instância é assinatura.	1
configServers	JSON	Não	Especificações do nó Configserver na instância de cluster sharded. Inclui os seguintes subparâmetros: nodeClass: tipo da instância do nó Configserver. Defina como 1 núcleo, 2 GB (uso geral). nodeStorage: capacidade de armazenamento do nó Configserver. Defina como 20 GB.	`[{"nodeClass":"dds.cs.mid","nodeStorage":"20"}]`
mongos	JSON	Não	Especificações do nó mongos na instância de cluster sharded. Contém o seguinte subparâmetro: nodeClass: tipo da instância do nó mongos. Para mais detalhes, consulte Tipos de instância.	`[{"nodeClass":"dds.mongos.mid"},{"nodeClass":"dds.mongos.mid"}]`
shards	JSON	Não	Especificações do nó shard. Abrange os seguintes subparâmetros: nodeClass: tipo da instância do nó shard. nodeStorage: capacidade de armazenamento do nó shard. Valor mínimo: 10. Unidade: GB. Nota Ao especificar o parâmetro shards, o parâmetro nodeStorage torna-se obrigatório. ReadonlyReplicas: número de nós somente leitura. Valores válidos: 0, 1, 2, 3, 4 e 5. Consulte Tipos de instância para mais informações.	`[{"nodeClass":"dds.shard.mid","ReadonlyReplicas":"1","nodeStorage":"10"},{"nodeClass":"dds.shard.mid","ReadonlyReplicas":"1","nodeStorage":"10"}]`
ReadonlyReplicas	String	Não	Número de nós somente leitura. Valores válidos: 0, 1, 2, 3, 4 e 5. Nota Recurso disponível exclusivamente para instâncias de conjunto de réplicas.	1
StorageType	String	Sim	Tipo de armazenamento da instância. Valores válidos: local_ssd: SSD local cloud_essd1: SSD aprimorado (ESSD) PL1 cloud_essd2: ESSD PL2 cloud_essd3: ESSD PL3 Nota Instâncias do ApsaraDB for MongoDB com MongoDB 4,2 ou anterior suportam SSDs locais. Instâncias do ApsaraDB for MongoDB executando MongoDB 4,4 ou superior aceitam ESSD PL1, ESSD PL2 e ESSD PL3.	cloud_essd1
ProvisionedIops	String	Não	IOPS provisionados da instância. Valores válidos: 0 a 50000. Este parâmetro é válido apenas quando o parâmetro StorageType está definido como cloud_auto.	0

Exemplos

Comprar uma instância de cluster sharded

O exemplo abaixo demonstra a compra de uma instância de cluster sharded com o método de faturamento por assinatura:

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

Alterar as configurações de uma instância de cluster sharded

Veja a seguir como alterar as configurações de um nó mongos em uma instância de cluster sharded com faturamento por assinatura:

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

Comprar uma instância de conjunto de réplicas

Este exemplo ilustra a aquisição de uma instância de conjunto de réplicas utilizando o modelo de assinatura:

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

Alterar as configurações de uma instância de conjunto de réplicas

A seguir, veja como modificar as configurações de uma instância de conjunto de réplicas sob o regime de pagamento conforme o uso:

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