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:
- Aprender cómo autorizar y autenticarla.
- Obtenga la región y el punto de conexión requeridos.
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
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
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 |
Sí |
String |
ID de instancia, que es compatible con el formato UUID. |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
X-Auth-Token |
Sí |
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 |
Sí |
String |
Tipo de contenido. Valor: application/json |
X-Language |
No |
String |
Tipo de idioma de solicitud. El valor predeterminado es en-us. Valores:
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
status |
Sí |
String |
Si está habilitado el escalado automático. Valores:
|
scaling_strategy |
Sí |
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.
|
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. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
flavor_switch |
Sí |
String |
Si las especificaciones de instancia se pueden escalar automáticamente hacia arriba o hacia abajo.
|
read_only_switch |
Sí |
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.
|
Parámetros de respuesta
Código de estado: 200
Parámetro |
Tipo |
Descripción |
---|---|---|
instance_id |
String |
ID de instancia. |
instance_name |
String |
Nombre de instancia. |
switch_status |
AutoScalingSwitchStatus object |
Estado de conmutador. |
Parámetro |
Tipo |
Descripción |
---|---|---|
scaling_switch |
String |
Si está habilitado el escalado automático. Valores:
|
flavor_switch |
String |
Si las especificaciones de instancia se pueden escalar automáticamente hacia arriba o hacia abajo. Valores:
|
read_only_switch |
String |
Si las réplicas de lectura se pueden agregar o eliminar automáticamente. Valores:
|
Código de estado: 400
Parámetro |
Tipo |
Descripción |
---|---|---|
error_code |
String |
Código de error. |
error_msg |
String |
Mensaje de error. |
Código de estado: 500
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.