Modificação de especificações de instância de banco de dados

Descrição da API

Essa API é usada para modificar as especificações de instâncias na mesma série de instâncias ou em séries diferentes.

Os serviços serão interrompidos por 5 a 10 minutos quando você modificar as especificações da instância de banco de dados. Tenha cuidado ao realizar esta operação.

Regras de alterações

Tabela 1 lista as especificações para as quais cada especificação de instância pode ser alterada. Tenha cuidado ao realizar esta operação. Depois que a especificação da instância é alterada, ela não pode ser alterada novamente.

√ indica que um item é suportado, e × indica que um item não é suportado.

Restrições

• Essa API é compatível com instâncias de banco de dados anuais/mensais e de pagamento por uso.
• Se você quiser alterar as especificações para outras especificações da mesma série, as novas especificações não podem ser as mesmas que as especificações originais.
• As especificações podem ser modificadas somente quando o status da instância de banco de dados é normal.

Depuração

Você pode depurar essa API no API Explorer.

URI

• Formato de URI

  POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/resize

• Exemplo de URI

  https://dds.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/9136fd2a9fcd405ea4674276ce36dae8in02/resize

Solicitações

• Descrição do parâmetro

  Tabela 3 Descrição do parâmetro

  Nome	Tipo	Obrigatório	Descrição
  resize	Object	Sim	A informação da especificação. Para obter mais informações, consulte Tabela 4.
  is_auto_pay	Boolean	Não	Se o pedido é pago automaticamente da sua conta quando você altera a classe de uma instância de banco de dados anual/mensal. Este parâmetro não afeta o modo de pagamento da renovação automática. Este parâmetro é inválido quando a classe de instância é reduzida. Quando a classe da instância é dimensionada, esse parâmetro pode ser definido como: true: indica que o pedido é pago automaticamente a partir da conta. false: indica que o pedido é pago manualmente a partir da conta. O valor padrão é false.

  Tabela 4 Descrição da estrutura de dados do campo resize

  Nome	Tipo	Obrigatório	Descrição
  target_type	String	Não	O tipo de objeto: Este parâmetro é obrigatório para uma instância de cluster. Se você modificar as especificações de um nó mongos, o valor é mongos. Se você modificar as especificações de um nó de shard, o valor será shard. Se você modificar as especificações de um nó de configuração, o valor será config. Esse parâmetro não é transferido para o conjunto de réplicas e instâncias de nó único.
  target_id	String	Sim	O ID do nó ou instância cujas especificações devem ser modificadas. Você pode obter o ID chamando a API usada para consultar instâncias. Se você não tiver uma instância, poderá chamar a API usada para criar uma instância. Se você modificar as especificações de um nó mongos, o valor será o ID do nó mongos. Se você modificar as especificações de um nó de shard, o valor será o ID do nó de shard. Se você modificar as especificações de um nó de configuração, o valor será o ID do nó de configuração. Para uma instância de conjunto de réplicas, o valor é o ID da instância de banco de dados. Para uma instância de nó único, o valor é o ID da instância de banco de dados.
  target_spec_code	String	Sim	O código de especificação do recurso da nova especificação. Para obter detalhes sobre como obter o valor, consulte os valores de flavors.spec_code em Consulta de especificações do banco de dados.

• Exemplo de solicitação
  Modificar as especificações do nó mongos.

  {
    "resize": {
      "target_type": "mongos",
      "target_id": "a742c13a284949adad177672e8a0f01cno02",
      "target_spec_code": "dds.mongodb.c6.large.4.mongos"
    }
  }

  Modificar as especificações do nó de shard.

  {
    "resize": {
      "target_type": "shard",
      "target_id": "aeeb40a704904977ad78993d138ec942gr02",
      "target_spec_code": "dds.momgodb.c6.large.4.shard"
    }
  }

  Modificar as especificações do nó de configuração.

  {
    "resize": {
      "target_type": "config",
      "target_id": "10a1c330537b42c1a9b3f7a5ebcda35egr02",
      "target_spec_code": "dds.momgodb.c6.xlarge.2.config"
    }
  }

  Modificar especificações de um conjunto de réplicas ou de uma instância de nó único.

  {
    "resize": {
      "target_id": "aeeb40a704904977ad78993d138ec942in02",
      "target_spec_code": "dds.mongodb.c6.medium.4.repset"
    }
  }

Respostas

• Descrição do parâmetro

  Tabela 5 Descrição do parâmetro

  Nome	Tipo	Obrigatório	Descrição
  job_id	String	Sim	A ID da tarefa.
  order_id	String	Não	O ID do pedido. Este parâmetro é retornado somente quando as especificações de uma instância de banco de dados anual/mensal são alteradas.

• Exemplo de resposta

  {
      "job_id": "3711e2ad-5787-49bc-a47f-3f0b066af9f5"
  }

SDK

Clique em SDK do Document Database Service DDS para fazer download do SDK ou exibir o documento do SDK. Para saber como instalar e autenticar um SDK, leia a seção Uso.

Código de status

Para obter mais informações, consulte Código de status.

Código de erro

Para obter mais informações, consulte Código de erro.