ModifyScalingRule - Auto Scaling - Centro de documentación de Alibaba Cloud

Modifica una regla de escalado.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ess:ModifyScalingRule

update

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ScalingRuleId	string	Sí	El ID de la regla de escalado que desea modificar.	asr-bp1dvirgwkoowxk7****
ScalingRuleName	string	No	El nombre de la regla de escalado. El nombre debe tener entre 2 y 64 caracteres de longitud y puede contener dígitos, letras mayúsculas, letras minúsculas, caracteres chinos, guiones bajos (_), guiones (-) y puntos (.). Debe comenzar con un dígito, una letra o un carácter chino. Nota El nombre de una regla de escalado debe ser único dentro del mismo grupo de escalado, bajo la misma cuenta de Alibaba Cloud y en la misma región.	scalingrule****
Cooldown	integer	No	El tiempo de enfriamiento de la regla de escalado. Este parámetro solo es aplicable a reglas de escalado simples. Valores válidos: 0 a 86400. Unidad: segundos.	60
MinAdjustmentMagnitude	integer	No	El número mínimo de instancias que se deben ajustar en una regla de escalado. Este parámetro solo surte efecto cuando el tipo de regla de escalado es `SimpleScalingRule` o `StepScalingRule` y `AdjustmentType` está establecido en `PercentChangeInCapacity`.	1
AdjustmentType	string	No	El método de ajuste de la regla de escalado. Este parámetro es aplicable a reglas de escalado simples y reglas de escalado por pasos, y es obligatorio en este caso. Valores válidos: QuantityChangeInCapacity: agrega o elimina un número específico de instancias ECS. PercentChangeInCapacity: agrega o elimina un porcentaje específico de instancias ECS. TotalCapacity: ajusta el número de instancias ECS en el grupo de escalado actual a un valor específico.	QuantityChangeInCapacity
AdjustmentValue	integer	No	El valor de ajuste de la regla de escalado. Este parámetro es aplicable a reglas de escalado simples y reglas de escalado por pasos, y es obligatorio en este caso. El número de instancias ECS ajustadas en una sola actividad de escalado no puede exceder 1,000. Los valores válidos varían según el método de ajuste: QuantityChangeInCapacity: -1000 a 1000. PercentChangeInCapacity: -100 a 10000. TotalCapacity: 0 a 2000.	100
EstimatedInstanceWarmup	integer	No	El período de calentamiento de una instancia. Este parámetro es aplicable a reglas de escalado de seguimiento de objetivo y reglas de escalado por pasos. Una instancia ECS en estado de calentamiento se agrega al grupo de escalado como se espera, pero CloudMonitor no reporta datos de monitoreo para la instancia durante este período. Nota Cuando el número de instancias ECS a escalar se calcula dinámicamente, las instancias en estado de calentamiento no se cuentan en el recuento de instancias existentes. Valores válidos: 0 a 86400. Unidad: segundos.	60
MetricName	string	No	La métrica predefinida. Este parámetro es aplicable a reglas de escalado de seguimiento de objetivo y reglas de escalado predictivo, y es obligatorio en este caso. Valores válidos para reglas de escalado de seguimiento de objetivo: CpuUtilizationAgent: (Agente) utilización de CPU (recomendado). MemoryUtilization: (Agente) utilización de memoria (recomendado). CpuUtilization: (ECS) utilización promedio de CPU. IntranetTx: (ECS) tráfico saliente promedio a través de la red interna. IntranetRx: (ECS) tráfico entrante promedio a través de la red interna. VpcInternetTx: (ECS) tráfico saliente promedio a través de Internet. VpcInternetRx: (ECS) tráfico entrante promedio a través de Internet. LoadBalancerRealServerAverageQps: (ALB) QPS por servidor en un grupo de servidores. Valores válidos para reglas de escalado predictivo: CpuUtilization: (ECS) utilización promedio de CPU. IntranetRx: (ECS) tráfico entrante promedio a través de la red interna. IntranetTx: (ECS) tráfico saliente promedio a través de la red interna. Para obtener más información, consulte Tareas activadas por eventos para el monitoreo del sistema.	CpuUtilization
TargetValue	number	No	El valor objetivo. Este parámetro es aplicable a reglas de escalado de seguimiento de objetivo y reglas de escalado predictivo. El valor de TargetValue puede tener hasta tres decimales y debe ser mayor que 0.	0.125
DisableScaleIn	boolean	No	Especifica si se debe deshabilitar la reducción horizontal. Este parámetro solo es aplicable a reglas de escalado de seguimiento de objetivo.	true
ScaleInEvaluationCount	integer	No	Después de crear una regla de escalado de seguimiento de objetivo, se crea automáticamente una tarea activada por eventos. Este parámetro especifica el número de veces consecutivas que se debe cumplir la condición de umbral antes de que la tarea activada por eventos de reducción horizontal correspondiente genere una alerta.	15
ScaleOutEvaluationCount	integer	No	Después de crear una regla de escalado de seguimiento de objetivo, se crea automáticamente una tarea activada por eventos. Este parámetro especifica el número de veces consecutivas que se debe cumplir la condición de umbral antes de que la tarea activada por eventos de expansión horizontal correspondiente genere una alerta.	3
PredictiveScalingMode	string	No	El modo de la regla de escalado predictivo. Valores válidos: PredictAndScale: genera resultados de predicción y crea tareas de predicción. PredictOnly: genera resultados de predicción pero no crea tareas de predicción.	PredictAndScale
PredictiveValueBehavior	string	No	El método utilizado para manejar el valor máximo de la regla de escalado predictivo. Valores válidos: MaxOverridePredictiveValue: el valor máximo inicial anula el valor predicho. Si el valor predicho es mayor que el valor máximo inicial, el valor máximo de la tarea de predicción se establece en el valor máximo inicial. PredictiveValueOverrideMax: el valor predicho anula el valor máximo inicial. Si el valor predicho es mayor que el valor máximo inicial, el valor máximo de la tarea de predicción se establece en el valor predicho. PredictiveValueOverrideMaxWithBuffer: el valor predicho se incrementa en un porcentaje específico. El valor predicho se incrementa según el porcentaje de PredictiveValueBuffer. Si el valor incrementado es mayor que el valor máximo inicial, se utiliza el valor incrementado.	MaxOverridePredictiveValue
PredictiveValueBuffer	integer	No	Este parámetro surte efecto cuando `PredictiveValueBehavior` está establecido en `PredictiveValueOverrideMaxWithBuffer`. El valor predicho se incrementa en este porcentaje. Si el valor incrementado es mayor que el valor máximo inicial, se utiliza el valor incrementado. Valores válidos: 0 a 100.	50
PredictiveTaskBufferTime	integer	No	Las tareas de predicción creadas automáticamente por una regla de escalado predictivo se ejecutan cada hora de forma predeterminada. Puede configurar un tiempo de búfer para ejecutar las tareas de predicción con antelación y preparar recursos por adelantado. Valores válidos: 0 a 60.	30
InitialMaxSize	integer	No	El número máximo de instancias en el grupo de escalado. Este parámetro se utiliza junto con PredictiveValueBehavior.	100
StepAdjustment	array<object>	No	La colección de información de ajustes por pasos para el escalado por pasos.
	object	No	La colección de información de ajustes por pasos para el escalado por pasos.
MetricIntervalUpperBound	number	No	El límite superior de un ajuste por pasos. Este parámetro solo es aplicable a reglas de escalado por pasos. Valores válidos: -9.999999E18 a 9.999999E18.	5.0
ScalingAdjustment	integer	No	El número de instancias que se deben escalar en un ajuste por pasos. Este parámetro solo es aplicable a reglas de escalado por pasos.	1
MetricIntervalLowerBound	number	No	El límite inferior de un ajuste por pasos. Este parámetro solo es aplicable a reglas de escalado por pasos. Valores válidos: -9.999999E18 a 9.999999E18.	1.0
AlarmDimension	array<object>	No	La información de dimensiones asociada con la métrica. Este parámetro es aplicable a reglas de escalado de seguimiento de objetivo. Configure este parámetro cuando la métrica requiera información de dimensiones adicionales. Por ejemplo, la métrica `LoadBalancerRealServerAverageQps` requiere la información de dimensión `rulePool`.
	object	No	La información de dimensiones asociada con la métrica. Este parámetro es aplicable a reglas de escalado de seguimiento de objetivo. Configure este parámetro cuando la métrica requiera información de dimensiones adicionales. Por ejemplo, la métrica `LoadBalancerRealServerAverageQps` requiere la información de dimensión `rulePool`.
DimensionKey	string	No	La clave de la dimensión asociada con la métrica.	rulePool
DimensionValue	string	No	El valor de la dimensión asociada con la métrica.	sgp-l1cbirz451yxu2****
MetricType	string	No	El tipo de métrica. Valores válidos: system: utiliza métricas del sistema de CloudMonitor. custom: utiliza métricas personalizadas reportadas a CloudMonitor. hybrid: utiliza métricas de Monitoreo de Nube Híbrida.	system
HybridMonitorNamespace	string	No	El ID del repositorio de métricas de monitoreo de Monitoreo de Nube Híbrida. Para administrar repositorios de métricas de monitoreo, consulte Administrar repositorios de métricas de monitoreo.	aliyun-test
HybridMetrics	array<object>	No	La configuración de métricas de monitoreo de Monitoreo de Nube Híbrida. Para obtener más información sobre cómo configurar este parámetro, consulte Usar reglas de escalado de seguimiento de objetivo personalizadas basadas en fórmulas.
	array<object>	No
Id	string	No	El ID de referencia de la métrica en la expresión de fórmula.	a
Expression	string	No	La expresión de fórmula para múltiples métricas de Monitoreo de Nube Híbrida. El resultado del cálculo de la expresión se utiliza para activar actividades de escalado. La expresión debe cumplir con la especificación de Notación Polaca Inversa (RPN) y solo se admiten los operadores `+ - * /`.	(a+b)/2
MetricName	string	No	El nombre de las métricas de monitoreo en el repositorio de métricas de monitoreo de Monitoreo de Nube Híbrida.	AliyunSmq_NumberOfMessagesVisible
Statistic	string	No	El método estadístico de la métrica. Valores válidos: Average: el promedio de todos los puntos de datos dentro del intervalo especificado. Minimum: el valor mínimo de todos los puntos de datos dentro del intervalo especificado. Maximum: el valor máximo de todos los puntos de datos dentro del intervalo especificado.	Average
Dimensions	array<object>	No	Las dimensiones de la métrica. Especifica los recursos que se deben monitorear para la métrica.
	object	No
DimensionKey	string	No	La clave de la dimensión de la métrica.	queue
DimensionValue	string	No	El valor de la dimensión de la métrica.	testQueue
AlarmOptions	object	No	Las definiciones de propiedades de alerta.
Period	integer	No	El período estadístico para los datos de monitoreo en la regla de escalado de seguimiento de objetivo. Unidad: segundos. Valores válidos: Nota Valor predeterminado: 60.	60

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.