Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ TaurusDB/ Referencia de la API/ Las API (recomendadas)/ Gestión de instancias/ Consulta de políticas de escalado automático
Actualización más reciente 2025-03-21 GMT+08:00

Consulta de políticas de escalado automático

Función

Esta API se utiliza para consultar políticas de escalado automático. Antes de invocar a esta API:

URI

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

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

String

Explicación:

ID de proyecto de un tenant en una región.

Para obtener este valor, consulte Obtención de un ID de proyecto.

Restricciones:

No hay

Rango de valores:

El valor puede contener 32 caracteres. Solo se permiten letras y dígitos.

Valor predeterminado:

No hay

instance_id

String

Explicación:

ID de instancia, que identifica de forma única una instancia.

Restricciones:

No hay

Rango de valores:

El valor puede contener 36 caracteres con in07 como el sufijo. Solo se permiten letras y dígitos.

Valor predeterminado:

No hay

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

String

Explicación:

Token de usuario.

Se puede obtener invocando a la API de IAM utilizada para obtener un token de usuario.

El valor de X-Subject-Token en el encabezado de respuesta es el valor del token.

Restricciones:

No hay

Rango de valores:

No hay

Valor predeterminado:

No hay

Content-Type

String

Explicación:

Tipo de contenido.

Restricciones:

No hay

Rango de valores:

application/json

Valor predeterminado:

No hay

X-Language

No

String

Explicación:

Tipo de idioma de solicitud.

Restricciones:

No hay

Rango de valores:

  • en-us
  • zh-cn

Valor predeterminado:

en-us

Parámetros de respuesta

Código de estado: 200

Tabla 3 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

id

String

Explicación:

ID de una política de escalado automático.

Rango de valores:

No hay

instance_id

String

Explicación:

ID de instancia.

Rango de valores:

El valor puede contener 36 caracteres con in07 como el sufijo. Solo se permiten letras y dígitos.

instance_name

String

Explicación:

Nombre de instancia.

Rango de valores:

El nombre debe comenzar con una letra y debe contener entre 4 y 64 caracteres. Solo se permiten letras (distinguen mayúsculas de minúsculas), dígitos, guiones (-) y guiones bajos (_).

status

String

Explicación:

Si está habilitado el escalado automático.

Rango de valores:

  • ON: habilitado
  • OFF: deshabilitado

monitor_cycle

Integer

Explicación:

Período de observación, en segundos. Durante todo el período de observación, si el uso promedio de CPU es mayor o igual que el valor preestablecido, se activa un escalamiento vertical.

Rango de valores:

  • 300
  • 600
  • 900
  • 1800

silence_cycle

Integer

Explicación:

Período de silencio, en segundos. Indica el intervalo mínimo entre dos operaciones de escalamiento vertical automático o dos operaciones de reducción vertical.

Rango de valores:

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

enlarge_threshold

Integer

Explicación:

Uso promedio de CPU.

Rango de valores:

50-100

max_flavor

String

Explicación:

Especificaciones máximas.

Rango de valores:

Especificaciones máximas que se pueden cambiar para una instancia en el sitio actual.

reduce_enabled

Boolean

Explicación:

Si el reducción vertical automático está habilitado.

Rango de valores:

  • true: habilitado.
  • false: deshabilitar

min_flavor

String

Explicación:

Especificaciones mínimas.

Rango de valores:

Especificaciones mínimas que se pueden cambiar para una instancia en el sitio actual.

silence_start_at

String

Explicación:

Hora de inicio del período de silencio (hora de fin del último cambio).

El formato es aaaa-mm-ddThh:mm:ssZ. T es el separador entre el calendario y la notación horaria del tiempo. Z indica el desplazamiento de la zona horaria. Por ejemplo, en la zona horaria de Beijing, el desplazamiento es de +0800.

Rango de valores:

No hay

scaling_strategy

ScalingStrategyInfo object

Explicación:

Política de escalado automático.

max_read_only_count

Integer

Explicación:

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

Rango de valores:

2 ≤ Cantidad de réplicas de lectura actuales < Valor preestablecido ≤ 15

min_read_only_count

Integer

Explicación:

Cantidad mínima de réplicas de lectura.

Rango de valores:

1–14

read_only_weight

Integer

Explicación:

Ponderaciones de lectura de réplicas de lectura.

Rango de valores:

0–1000

Tabla 4 ScalingStrategyInfo

Parámetro

Tipo

Descripción

flavor_switch

String

Explicación:

Si las especificaciones de instancia se pueden escalar automáticamente hacia arriba o hacia abajo.

Rango de valores:

  • ON: Sí
  • OFF: No

read_only_switch

String

Explicación:

Si las réplicas de lectura se pueden agregar o eliminar automáticamente.

Rango de valores:

  • ON: Sí
  • OFF: No

Código de estado: 400

Tabla 5 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Código de estado: 500

Tabla 6 Parámetros de body de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Ejemplo de la solicitud

Consulta de políticas de escalado automático

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

Ejemplo de la respuesta

Código de estado: 200

Operación exitosa.

  • Realizar una consulta después de habilitar el ajuste 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
    }
  • Realizar una consulta después de deshabilitar el ajuste automático
    {
      "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 estado

Código de estado

Descripción

200

Operación exitosa.

400

Error de cliente.

500

Error de servidor.

Código de error

Para obtener más información, véase Códigos de error.