Todos os produtos
Search

Este produto

    :ModifyDBInstanceSpec

    Central de documentação

    :ModifyDBInstanceSpec

    Última atualização: Jul 08, 2026

    Modifica as especificações ou o espaço de armazenamento de uma instância standalone, conjunto de réplicas ou serverless do ApsaraDB for MongoDB. As instâncias serverless estão disponíveis apenas no site da China (aliyun.com).

    Antes de chamar esta operação, certifique-se de compreender os métodos de faturamento e a precificação do ApsaraDB for MongoDB.

    Esta operação aplica-se apenas a instâncias standalone e conjuntos de réplicas. Para modificar as especificações de instâncias de cluster sharded, chame a operação ModifyNodeSpec, CreateNode, DeleteNode ou ModifyNodeSpecBatch.

    Depuração

    O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

    Parâmetros da solicitação

    Parâmetro Tipo Obrigatório Exemplo Descrição
    Action String Sim ModifyDBInstanceSpec

    Operação a ser executada. Defina o valor como ModifyDBInstanceSpec.

    RegionId String Não cn-hangzhou

    ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

    DBInstanceId String Sim dds-bp1ea17b41ab****

    ID da instância.

    DBInstanceClass String Não dds.sn4.xlarge.1

    Tipo da instância. Para obter mais informações, consulte Tipos de instância. Também é possível chamar a operação DescribeAvailableResource para visualizar os tipos de instância.

    Nota Especifique pelo menos um dos parâmetros DBInstanceClass e DBInstanceStorage.
    DBInstanceStorage String Não 50

    Capacidade de armazenamento da instância. Valores válidos: 10 a 3000. O valor deve ser múltiplo de 10. Unidade: GB. Os valores permitidos dependem do tipo de instância. Para obter mais informações, consulte Tipos de instância.

    Nota
    • Especifique pelo menos um dos parâmetros DBInstanceStorage e DBInstanceClass.
    • A redução da capacidade de armazenamento é permitida apenas para instâncias de conjunto de réplicas com pagamento conforme o uso. A nova capacidade definida deve ser superior à capacidade já utilizada.
    OrderType String Não UPGRADE

    Tipo de modificação. Valores válidos:

    • UPGRADE
    • DOWNGRADE
    Nota Configure este parâmetro apenas se o método de faturamento da instância for assinatura.
    AutoPay Boolean Não true

    Defina se o pagamento automático será ativado. Valor padrão: true. Valores válidos:

    • true: ativa o pagamento automático. Certifique-se de que sua conta Alibaba Cloud tenha saldo suficiente.
    • false: desativa o pagamento automático. Para pagar pela instância, siga estas etapas: faça login no console do ApsaraDB for MongoDB. No canto superior direito da página, escolha Expenses > User Center. No painel de navegação à esquerda, escolha Order Management > Order. Na aba Orders for Services, localize o pedido e efetue o pagamento.
    BusinessInfo String Não {“ActivityId":"000000000"}

    Informações comerciais.

    ReplicationFactor String Não 3

    Número de nós na instância.

    • Valores válidos para conjuntos de réplicas: 3, 5 e 7
    • Valor válido para instâncias standalone: 1
    Nota Este parâmetro não é obrigatório para instâncias serverless, disponíveis apenas no site da China (aliyun.com).
    ReadonlyReplicas String Não 1

    Número de nós somente leitura. Valores válidos: 0 a 5.

    Se a instância possuir apenas endpoints de Classic Network e VPC, solicite um endpoint público ou libere o endpoint de rede clássica antes de alterar o valor de Read-only Nodes.

    Nota Acesse a página Database Connections para visualizar os tipos de rede habilitados.
    CouponNo String Não youhuiquan_promotion_option_id_for_blank

    Código do cupom. Valor padrão: youhuiquan_promotion_option_id_for_blank.

    EffectiveTime String Não Immediately

    Momento em que as configurações alteradas entram em vigor. Valor padrão: Immediately. Valores válidos:

    • Immediately: as configurações entram em vigor imediatamente.
    • MaintainTime: as configurações entram em vigor durante a janela de manutenção da instância.

    Parâmetros de resposta

    Parâmetro

    Tipo

    Exemplo

    Descrição

    RequestId

    String

    1E9F1104-19E7-59F0-AB7F-F4EBFDEA****

    ID da solicitação.

    OrderId

    String

    21012408824****

    ID do pedido.

    Exemplos

    Exemplos de solicitações

    http(s)://mongodb.aliyuncs.com/?Action=ModifyDBInstanceSpec
&DBInstanceId=dds-bp1ea17b41ab****
&DBInstanceClass=dds.sn4.xlarge.1
&DBInstanceStorage=50
&OrderType=UPGRADE
&AutoPay=true
&BusinessInfo={“ActivityId":"000000000"}
&ReplicationFactor=3
&ReadonlyReplicas=1
&CouponNo=youhuiquan_promotion_option_id_for_blank
&EffectiveTime=Immediately
&Common request parameters

    Exemplos de respostas de sucesso

    Formato XML

    HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDBInstanceSpecResponse>
    <RequestId>1E9F1104-19E7-59F0-AB7F-F4EBFDEA****</RequestId>
    <OrderId>21012408824****</OrderId>
</ModifyDBInstanceSpecResponse>

    Formato JSON

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "1E9F1104-19E7-59F0-AB7F-F4EBFDEA****",
  "OrderId" : "21012408824****"
}

    Códigos de erro

    Para obter uma lista de códigos de erro, visite a Central de Erros de API.