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/ Modificación de políticas de escalado automático
Actualización más reciente 2025-03-21 GMT+08:00

Modificación de políticas de escalado automático

Función

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

Restricciones

Esta API está en la fase de prueba beta abierta (OBT). Para usar esta API, envíe un ticket de servicio.

URI

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

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

String

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

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

instance_id

String

ID de instancia, que es compatible con el formato UUID.

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

String

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.

Content-Type

String

Tipo de contenido.

Valor: application/json

X-Language

No

String

Tipo de idioma de solicitud. El valor predeterminado es en-us. Valores:

  • en-us
  • zh-cn
Tabla 3 Parámetros del cuerpo de solicitud

Parámetro

Obligatorio

Tipo

Descripción

status

String

Si está habilitado el escalado automático.

Valores:

  • ON: habilitado
  • OFF: deshabilitado

scaling_strategy

ScalingStrategyReqInfo object

Política de escalado automático.

monitor_cycle

No

Integer

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.

Valor: 300, 600, 900 o 1800.

Este parámetro es obligatorio cuando status se establece en ON.

silence_cycle

No

Integer

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.

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

Este parámetro es obligatorio cuando status se establece en ON.

enlarge_threshold

No

Integer

Uso promedio de CPU (%).

Rango de valores: 50–100.

Este parámetro es obligatorio cuando status se establece en ON.

max_flavor

No

String

Especificaciones máximas. Este parámetro es obligatorio cuando las especificaciones de instancia se escalan automáticamente hacia arriba o hacia abajo.

reduce_enabled

No

Boolean

Si la caída automática está habilitada. Este parámetro es obligatorio cuando está activado el ajuste automático.

  • true: habilitar
  • false: deshabilitar

max_read_only_count

No

Integer

Número máximo de réplicas de lectura. Este parámetro es obligatorio cuando las réplicas de lectura se agregan o eliminan automáticamente.

read_only_weight

No

Integer

Ponderaciones de lectura de réplicas de lectura. Este parámetro es obligatorio cuando las réplicas de lectura se agregan o eliminan automáticamente.

Tabla 4 ScalingStrategyReqInfo

Parámetro

Obligatorio

Tipo

Descripción

flavor_switch

String

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

  • ON: Sí
  • OFF: No

read_only_switch

String

Si las réplicas de lectura se pueden agregar o eliminar automáticamente. Para utilizar esta función, asegúrese de que solo hay una instancia de proxy. Para obtener detalles sobre cómo crear una instancia de proxy, véase Creación de una instancia proxy.

  • ON: Sí
  • OFF: No

Parámetros de respuesta

Código de estado: 200

Tabla 5 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

instance_id

String

ID de instancia.

instance_name

String

Nombre de instancia.

switch_status

AutoScalingSwitchStatus object

Estado de conmutador.

Tabla 6 AutoScalingSwitchStatus

Parámetro

Tipo

Descripción

scaling_switch

String

Si está habilitado el escalado automático.

Valores:

  • ON: habilitado
  • OFF: deshabilitado

flavor_switch

String

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

Valores:

  • ON: Las especificaciones de instancia se pueden escalar hacia arriba o hacia abajo automáticamente.
  • OFF: las especificaciones de instancia no se pueden escalar hacia arriba o hacia abajo automáticamente.

read_only_switch

String

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

Valores:

  • ON: las réplicas de lectura se pueden agregar o eliminar automáticamente.
  • OFF: las réplicas de lectura no se pueden agregar ni eliminar automáticamente.

Código de estado: 400

Tabla 7 Parámetros del cuerpo 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 8 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Ejemplo de la solicitud

Modificación de políticas de escalado 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"
}

Ejemplo de la respuesta

Código de estado: 200

Operación exitosa.

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

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.