Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ TaurusDB/ Referência de API/ APIs (recomendadas)/ Gerenciamento de instâncias/ Modificação de políticas de dimensionamento automático
Atualizado em 2025-05-23 GMT+08:00
Ver PDF
Compartilhar

Modificação de políticas de dimensionamento automático

Função

Essa API é usada para modificar políticas de dimensionamento automático. Antes de chamar essa API:

Restrições

Essa API está na fase de teste beta aberto (OBT). Para usar essa API, envie um tíquete de serviço.

URI

PUT /v3/{project_id}/instances/{instance_id}/auto-scaling/policy

Tabela 1 Parâmetros de URI

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto de um locatário numa região.

Para obter esse valor, consulte Obtenção de um ID de projeto.

instance_id

Sim

String

ID da instância, que é compatível com o formato UUID.

Parâmetros de solicitação

Tabela 2 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário.

Ele pode ser obtido chamando a API do IAM usada para obter um token de usuário.

O valor de X-Subject-Token no cabeçalho da resposta é o valor do token.

Content-Type

Sim

String

Tipo de conteúdo.

Valor: application/json

X-Language

Não

String

Tipo de linguagem da solicitação. O valor padrão é en-us. Valores:

  • en-us
  • zh-cn
Tabela 3 Parâmetros do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

status

Sim

String

Se o dimensionamento automático está ativado.

Valores:

  • ON: ativado
  • OFF: desativado

scaling_strategy

Sim

ScalingStrategyReqInfo object

Política de dimensionamento automático.

monitor_cycle

Não

Integer

Período de observação, em segundos. Durante todo o período de observação, se o uso médio da CPU for maior ou igual ao valor predefinido, um aumento de escala é acionado.

Valor: 300, 600, 900 ou 1800.

Este parâmetro é obrigatório quando status é definido como ON.

silence_cycle

Não

Integer

Período de silêncio, em segundos. Indica o intervalo mínimo entre duas operações de aumento de escala automática ou duas operações de redução de escala.

Valor: 300, 600, 1800, 3600, 7200, 10800, 86400 ou 604800.

Este parâmetro é obrigatório quando status é definido como ON.

enlarge_threshold

Não

Integer

Uso médio da CPU (%).

Intervalo de valores: 50–100.

Este parâmetro é obrigatório quando status é definido como ON.

max_flavor

Não

String

Especificações máximas. Esse parâmetro é obrigatório quando as especificações da instância são automaticamente dimensionadas para cima ou para baixo.

reduce_enabled

Não

Boolean

Se a redução automática está ativada. Esse parâmetro é obrigatório quando o dimensionamento automático está ativado.

  • true: ativado
  • false: desativado

max_read_only_count

Não

Integer

Número máximo de réplicas de leitura. Este parâmetro é obrigatório quando réplicas de leitura são adicionadas ou excluídas automaticamente.

read_only_weight

Não

Integer

Pesos de leitura das réplicas de leitura. Este parâmetro é obrigatório quando réplicas de leitura são adicionadas ou excluídas automaticamente.
Tabela 4 ScalingStrategyReqInfo

Parâmetro

Obrigatório

Tipo

Descrição

flavor_switch

Sim

String

Se as especificações da instância podem ser automaticamente dimensionadas para cima ou para baixo.

  • ON: sim
  • OFF: não

read_only_switch

Sim

String

Se as réplicas de leitura podem ser adicionadas ou excluídas automaticamente. Para usar essa função, certifique-se de que haja apenas uma instância de proxy. Para obter detalhes sobre como criar uma instância de proxy, consulte Criação de uma instância de proxy.

  • ON: sim
  • OFF: não

Parâmetros de resposta

Código de status: 200

Tabela 5 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

instance_id

String

ID da instância.

instance_name

String

Nome da instância.

switch_status

AutoScalingSwitchStatus object

Status do switch.
Tabela 6 AutoScalingSwitchStatus

Parâmetro

Tipo

Descrição

scaling_switch

String

Se o dimensionamento automático está ativado.

Valores:

  • ON: ativado
  • OFF: desativado

flavor_switch

String

Se as especificações da instância podem ser automaticamente dimensionadas para cima ou para baixo.

Valores:

  • ON: as especificações da instância podem ser automaticamente dimensionadas para cima ou para baixo.
  • OFF: as especificações da instância não podem ser automaticamente dimensionadas para cima ou para baixo.

read_only_switch

String

Se as réplicas de leitura podem ser adicionadas ou excluídas automaticamente.

Valores:

  • ON: réplicas de leitura podem ser adicionadas ou excluídas automaticamente.
  • OFF: réplicas de leitura não podem ser adicionadas ou excluídas automaticamente.

Código de status: 400

Tabela 7 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Código de status: 500

Tabela 8 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Exemplo de solicitação

Modificação de políticas de dimensionamento automático

PUT https://{endpoint}/v3/97b026aa9cc4417888c14c84a1ad9860/instances/61a4ea66210545909d74a05c27a7179ein07/auto-scaling/policy

{
  "enlarge_threshold" : 50,
  "max_flavor" : "gaussdb.mysql.large.x86.4",
  "max_read_only_count" : 2,
  "monitor_cycle" : 300,
  "read_only_weight" : 10,
  "reduce_enabled" : false,
  "scaling_strategy" : {
    "flavor_switch" : "ON",
    "read_only_switch" : "ON"
  },
  "silence_cycle" : 300,
  "status" : "ON"
}

Exemplo de resposta

Código de status: 200

Bem-sucedido.

{
  "instance_id" : "61a4ea66210545909d74a05c27a7179ein07",
  "instance_name" : "gauss-test-1",
  "switch_status" : {
    "scaling_switch" : "ON",
    "flavor_switch" : "ON",
    "read_only_switch" : "ON"
  }
}

Código de status

Código de status

Descrição

200

Bem-sucedido.

400

Erro do cliente.

500

Erro no servidor.

Código de erro

Para obter detalhes, consulte Códigos de erro.

Tópico principal: Gerenciamento de instâncias