Todos os produtos
Search
Central de documentação

:UpgradeDBInstanceEngineVersion

Última atualização: Jul 08, 2026

Atualiza a versão do banco de dados de uma instância do ApsaraDB for MongoDB.

A instância deve estar em execução ao chamar esta operação.

Nota
  • As versões de banco de dados disponíveis dependem do mecanismo de armazenamento da instância. Para mais informações, consulte Atualizações de versões principais do MongoDB. Você também pode chamar a operação DescribeAvailableEngineVersion para consultar as versões disponíveis.

  • Não é possível fazer downgrade da versão do MongoDB após a atualização.

  • A instância reinicia automaticamente de duas a três vezes durante a atualização. Realize o procedimento fora dos horários de pico.

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âmetroTipoObrigatórioExemploDescrição
ActionStringSimUpgradeDBInstanceEngineVersion

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

RegionIdStringNãocn-hangzhou

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

DBInstanceIdStringSimdds-bpxxxxxxxx

ID da instância.

EngineVersionStringSim4.0

Versão de destino da atualização. Valores válidos: 3.4, 4.0 e 4.2.

Nota A versão especificada deve ser superior à versão atual da instância.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

C4907B00-A208-4E0C-A636-AA85140E406C

ID da solicitação.

Exemplos

Solicitações de exemplo

http(s)://mongodb.aliyuncs.com/?Action=UpgradeDBInstanceEngineVersion
&EngineVersion=4.0
&DBInstanceId=dds-bpxxxxxxxx
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<?xml version="1.0" encoding="UTF-8" ?>
<UpgradeDBInstanceEngineVersionResponse>
    <RequestId>C4907B00-A208-4E0C-A636-AA85140E406C</RequestId>
</UpgradeDBInstanceEngineVersionResponse>

Formato JSON

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

{
  "RequestId" : "C4907B00-A208-4E0C-A636-AA85140E406C"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.