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/ Consulta de políticas de dimensionamento automático
Atualizado em 2025-05-23 GMT+08:00
Ver PDF
Compartilhar

Consulta de políticas de dimensionamento automático

Função

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

URI

GET /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

Explicação:

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

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

Restrições:

Nenhuma

Intervalo de valores:

O valor pode conter 32 caracteres. Apenas letras e dígitos são permitidos.

Valor padrão:

Nenhum

instance_id

Sim

String

Explicação:

ID da instância, que identifica exclusivamente uma instância.

Restrições:

Nenhuma

Intervalo de valores:

O valor pode conter 36 caracteres com um sufixo de in07. Apenas letras e dígitos são permitidos.

Valor padrão:

Nenhum

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

Explicação:

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.

Restrições:

Nenhuma

Intervalo de valores:

Nenhum

Valor padrão:

Nenhum

Content-Type

Sim

String

Explicação:

Tipo de conteúdo.

Restrições:

Nenhuma

Intervalo de valores:

application/json

Valor padrão:

Nenhum

X-Language

Não

String

Explicação:

Tipo de linguagem da solicitação.

Restrições:

Nenhuma

Intervalo de valores:

  • en-us
  • zh-cn

Valor padrão:

en-us

Parâmetros de resposta

Código de status: 200

Tabela 3 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

id

String

Explicação:

ID de uma política de dimensionamento automático.

Intervalo de valores:

Nenhum

instance_id

String

Explicação:

ID da instância.

Intervalo de valores:

O valor pode conter 36 caracteres com um sufixo de in07. Apenas letras e dígitos são permitidos.

instance_name

String

Explicação:

Nome da instância.

Intervalo de valores:

O nome deve começar com uma letra e consistir de 4 a 64 caracteres. Somente letras (diferenciando maiúsculas de minúsculas), dígitos, hifens (-) e sublinhados (_) são permitidos.

status

String

Explicação:

Se o dimensionamento automático está ativado.

Intervalo de valores:

  • ON: ativado
  • OFF: desativado

monitor_cycle

Integer

Explicação:

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.

Intervalo de valores:

  • 300
  • 600
  • 900
  • 1800

silence_cycle

Integer

Explicação:

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.

Intervalo de valores:

  • 300
  • 600
  • 1800
  • 3600
  • 7200
  • 10800
  • 86400
  • 604800

enlarge_threshold

Integer

Explicação:

Uso médio da CPU.

Intervalo de valores:

50-100

max_flavor

String

Explicação:

Especificações máximas.

Intervalo de valores:

Especificações máximas que podem ser alteradas para uma instância no site atual.

reduce_enabled

Não

Explicação:

Se a redução automática de escala está ativada.

Intervalo de valores:

  • true: ativada
  • false: desativada

min_flavor

String

Explicação:

Especificações mínimas.

Intervalo de valores:

Especificações mínimas que podem ser alteradas para uma instância no site atual.

silence_start_at

String

Explicação:

Hora de início do período de silêncio (hora de término da última alteração).

O formato é aaaa-mm-ddThh:mm:ssZ. T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, no fuso horário de Pequim, o deslocamento é +0800.

Intervalo de valores:

Nenhum

scaling_strategy

ScalingStrategyInfo object

Explicação:

Política de dimensionamento automático.

max_read_only_count

Integer

Explicação:

Número máximo de réplicas de leitura.

Intervalo de valores:

2 ≤ Número de réplicas de leitura atuais < Valor predefinido ≤ 15

min_read_only_count

Integer

Explicação:

Número mínimo de réplicas de leitura.

Intervalo de valores:

1–14

read_only_weight

Integer

Explicação:

Pesos de leitura das réplicas de leitura.

Intervalo de valores:

0–1000
Tabela 4 ScalingStrategyInfo

Parâmetro

Tipo

Descrição

flavor_switch

String

Explicação:

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

Intervalo de valores:

  • ON: sim
  • OFF: não

read_only_switch

String

Explicação:

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

Intervalo de valores:

  • ON: sim
  • OFF: não

Código de status: 400

Tabela 5 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 6 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

Consulta de políticas de dimensionamento automático

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

Exemplo de resposta

Código de status: 200

Bem-sucedido.

  • Execução de uma consulta após a ativação do dimensionamento automático 
    {
  "id" : "26d8e193-1ea0-4adb-89d0-d1343399d0e7",
  "instance_id" : "41ff7519e22d44eea6066615fa5b17c7in07",
  "instance_name" : "gauss-test-1",
  "status" : "ON",
  "monitor_cycle" : 300,
  "silence_cycle" : 300,
  "enlarge_threshold" : 50,
  "max_flavor" : "gaussdb.mysql.large.x86.4",
  "reduce_enabled" : false,
  "min_flavor" : "gaussdb.mysql.medium.x86.4",
  "silence_start_at" : "2023-08-31T08:59:09+0000",
  "scaling_strategy" : {
    "flavor_switch" : "ON",
    "read_only_switch" : "ON"
  },
  "max_read_only_count" : 2,
  "min_read_only_count" : 1,
  "read_only_weight" : 10
}
  • Execução de uma consulta após o dimensionamento automático ser desativado 
    {
  "id" : null,
  "instance_id" : "41ff7519e22d44eea6066615fa5b17c7in07",
  "instance_name" : "gauss-test-1",
  "status" : "OFF",
  "monitor_cycle" : null,
  "silence_cycle" : null,
  "enlarge_threshold" : null,
  "max_flavor" : null,
  "reduce_enabled" : null,
  "min_flavor" : null,
  "silence_start_at" : "",
  "scaling_strategy" : {
    "flavor_switch" : "",
    "read_only_switch" : ""
  },
  "max_read_only_count" : null,
  "min_read_only_count" : null,
  "read_only_weight" : null
}

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