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 2024-09-29 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

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.

Para obter o valor, chame a API para obtenção de um token de usuário.

Depois que a solicitação é processada, o valor de X-Subject-Token no cabeçalho da mensagem é o valor do token.

X-Language

Não

String

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

  • en-us
  • zh-cn

Content-Type

Sim

String

Tipo de conteúdo.

Valor: application/json

Parâmetros de resposta

Código de status: 200

Tabela 3 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

id

String

ID da consulta de políticas de dimensionamento automático.

instance_id

String

ID da instância.

instance_name

String

Nome da instância.

status

String

Se o dimensionamento automático está ativado.

Valor:

  • ON: ativado
  • OFF: desativado

monitor_cycle

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.

silence_cycle

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.

enlarge_threshold

Integer

Uso médio da CPU.

max_flavor

String

Máximas especificações.

reduce_enabled

Boolean

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

Valor:

  • true: ativada
  • false: desativada

min_flavor

String

Especificações mínimas de instância.

silence_start_at

String

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 do fuso horário é mostrado como +0800.

scaling_strategy

ScalingStrategyInfo object

Política de dimensionamento automático.

max_read_only_count

Integer

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

min_read_only_count

Integer

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

read_only_weight

Integer

Pesos de leitura das réplicas de leitura.
Tabela 4 ScalingStrategyInfo

Parâmetro

Tipo

Descrição

flavor_switch

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

String

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

  • 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