Si necesita aumentar o disminuir automáticamente el número de instancias de un tipo específico según los cambios y las políticas del negocio, puede configurar un grupo de escalado para ajustar automáticamente su capacidad de cómputo (es decir, el número de instancias). Si los atributos actuales del grupo de escalado ya no cumplen con los requisitos de su negocio, puede llamar a la operación ModifyScalingGroup para modificar atributos del grupo de escalado como el número máximo de instancias, el número mínimo de instancias o el número esperado de instancias. De este modo, no necesita crear un grupo de escalado nuevamente ni reconfigurar los atributos relacionados, lo que ahorra tiempo y recursos.
Descripción de la operación
Descripción de la operación
-
No se pueden modificar los siguientes parámetros:
-
RegionId
-
LoadBalancerId
NotaPara modificar las instancias de load balancer, utilice las operaciones AttachLoadBalancers y DetachLoadBalancers.
-
DBInstanceId
NotaPara modificar las instancias de ApsaraDB RDS, utilice las operaciones AttachDBInstances y DetachDBInstances.
-
-
Solo puede invocar esta operación cuando el grupo de escalado se encuentra en estado Active o Inactive.
-
Habilitar una nueva configuración de escalado no afecta a las instancias de ECS ni a las instancias de contenedor elástico que se crearon basándose en la configuración de escalado anterior y que siguen en ejecución.
-
Si modifica MaxSize y el número de instancias de ECS o de contenedor elástico en el grupo de escalado supera el nuevo valor de MaxSize, Auto Scaling elimina automáticamente instancias del grupo de escalado hasta que el número de instancias sea igual al valor de MaxSize.
-
Si modifica MinSize y el número de instancias de ECS o de contenedor elástico en el grupo de escalado es menor que el nuevo valor de MinSize, Auto Scaling agrega automáticamente instancias al grupo de escalado hasta que el número de instancias sea igual al valor de MinSize.
-
Si se establece DesiredCapacity para el grupo de escalado y modifica DesiredCapacity, Auto Scaling agrega o elimina automáticamente instancias de ECS o de contenedor elástico para garantizar que el número de instancias en el grupo de escalado sea igual al valor de DesiredCapacity.
Pruébelo ahora
Test
Autorización de RAM
|
Action |
Nivel de acceso |
Tipo de recurso |
Clave de condición |
Acción dependiente |
|
ess:ModifyScalingGroup |
update |
*ScalingGroup.
|
Ninguna | Ninguna |
Parámetros de la solicitud
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
Ejemplo |
| ScalingGroupId |
string |
Sí |
El ID del grupo de escalado que desea modificar. |
asg-bp1ffogfdauy0jw0**** |
| ScalingGroupName |
string |
No |
El nombre del grupo de escalado. El nombre debe ser único dentro de una región. 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. |
scalinggroup**** |
| MinSize |
integer |
No |
El número mínimo de instancias de ECS o instancias de contenedor elástico en el grupo de escalado. Cuando el número de instancias de ECS o de contenedor elástico en el grupo de escalado es menor que el valor de Nota
El valor de |
1 |
| MaxSize |
integer |
No |
El número máximo de instancias de ECS o instancias de contenedor elástico en el grupo de escalado. Cuando el número de instancias de ECS o de contenedor elástico en el grupo de escalado supera el valor de Los valores válidos de MaxSize dependen de su uso de Auto Scaling. Vaya al Centro de cuotas para consultar la cuota de Número máximo de instancias en un grupo de escalado. Por ejemplo, si la cuota de Número máximo de instancias en un grupo de escalado es 2000, los valores válidos de |
99 |
| DefaultCooldown |
integer |
No |
El tiempo de espera (cooldown) después de que se completa una actividad de escalado (agregar o eliminar instancias de ECS o instancias de contenedor elástico). Valores válidos: 0 a 86400. Unidad: segundos. Durante el tiempo de espera, el grupo de escalado no ejecuta otras actividades de escalado. Este parámetro solo se aplica a las actividades de escalado activadas por tareas basadas en eventos de CloudMonitor. |
600 |
| RemovalPolicy.1 |
string |
No |
La política de reducción de prioridad uno para eliminar instancias de ECS del grupo de escalado. Valores válidos:
Nota
La configuración de escalado mencionada en OldestScalingConfiguration se refiere al origen de configuración de la instancia, que incluye configuraciones de escalado y plantillas de lanzamiento. CustomPolicy solo se puede establecer como la política de reducción de primera prioridad. Cuando especifica CustomPolicy, también debe especificar el parámetro CustomPolicyARN. |
OldestScalingConfiguration |
| RemovalPolicy.2 |
string |
No |
La política de reducción de prioridad dos para eliminar instancias de ECS del grupo de escalado. Valores válidos:
Nota
La configuración de escalado mencionada en OldestScalingConfiguration se refiere al origen de configuración de la instancia, que incluye configuraciones de escalado y plantillas de lanzamiento. |
NewestInstance |
| RemovalPolicy.3 |
string |
No |
La política de reducción de prioridad tres para eliminar instancias de ECS del grupo de escalado. Valores válidos:
Nota
La configuración de escalado mencionada en OldestScalingConfiguration se refiere al origen de configuración de la instancia, que incluye configuraciones de escalado y plantillas de lanzamiento. |
OldestInstance |
| ActiveScalingConfigurationId |
string |
No |
El ID de la configuración de escalado activa en el grupo de escalado. |
asc-bp17pelvl720x5ub**** |
| HealthCheckType |
string |
No |
El modo de comprobación de estado del grupo de escalado. Valores válidos:
Valor predeterminado: ECS. Nota
Para habilitar tanto las comprobaciones de estado de las instancias como las del load balancer, utilice el parámetro |
ECS |
| LaunchTemplateId |
string |
No |
El ID de la plantilla de lanzamiento de la cual el grupo de escalado obtiene la información de configuración de lanzamiento. |
lt-m5e3ofjr1zn1aw7**** |
| LaunchTemplateVersion |
string |
No |
La versión de la plantilla de lanzamiento. Valores válidos:
|
Default |
| OnDemandBaseCapacity |
integer |
No |
El número mínimo de instancias de pago por uso requeridas en el grupo de escalado. Valores válidos: 0 a 1000. Cuando el número de instancias de pago por uso es menor que este valor, se crean preferentemente instancias de pago por uso. Cuando el parámetro |
30 |
| OnDemandPercentageAboveBaseCapacity |
integer |
No |
El porcentaje de instancias de pago por uso entre las instancias excedentes después de cumplir con el número mínimo de instancias de pago por uso (OnDemandBaseCapacity). Valores válidos: 0 a 100. Cuando el parámetro |
20 |
| SpotInstanceRemedy |
boolean |
No |
Especifica si se deben complementar las instancias spot. Cuando esta función está habilitada y el grupo de escalado recibe un mensaje del sistema de que una instancia spot está a punto de ser recuperada, el grupo de escalado intenta crear una nueva instancia para reemplazar la instancia spot que está a punto de ser recuperada. |
true |
| CompensateWithOnDemand |
boolean |
No |
Especifica si se deben crear automáticamente instancias de pago por uso para cumplir con el número requerido de instancias de ECS cuando no se pueden crear instancias spot debido a razones como el costo o un inventario insuficiente. Este parámetro solo surte efecto cuando el parámetro
|
true |
| SpotInstancePools |
integer |
No |
El número de tipos de instancia disponibles. El grupo de escalado crea instancias spot de varios tipos al costo más bajo. Valores válidos: 0 a 10. Cuando el parámetro |
5 |
| DesiredCapacity |
integer |
No |
El número esperado de instancias de ECS o instancias de contenedor elástico en el grupo de escalado. Establecer este parámetro habilita la función de número esperado de instancias. El grupo de escalado mantiene automáticamente el número de instancias de ECS o de contenedor elástico en el número esperado. Valores válidos: MinSize ≤ DesiredCapacity ≤ MaxSize. Nota
Si deshabilita y luego vuelve a habilitar la función de número esperado de instancias, debe establecer el valor de |
5 |
| GroupDeletionProtection |
boolean |
No |
Especifica si se debe habilitar la protección contra eliminación para el grupo de escalado. Valores válidos:
|
true |
| MultiAZPolicy |
string |
No |
La política de escalado para instancias de ECS en un grupo de escalado multizona. Valores válidos:
|
PRIORITY |
| VSwitchIds |
array |
No |
Los ID de uno o más vSwitches. Este parámetro solo surte efecto cuando el tipo de red del grupo de escalado es VPC. Los vSwitches especificados deben pertenecer a la misma VPC que el grupo de escalado. Los vSwitches pueden abarcar varias zonas. La prioridad de los vSwitches se ordena en orden numérico ascendente, donde 1 indica la prioridad más alta. Cuando no se puede crear una instancia de ECS en la zona de un vSwitch de mayor prioridad, el sistema selecciona automáticamente el siguiente vSwitch de mayor prioridad. |
vsw-bp1oo2a7isyrb8igf**** |
|
string |
No |
Los ID de uno o más vSwitches. Valores válidos de N: 1 a 5. Este parámetro solo surte efecto cuando el tipo de red del grupo de escalado es VPC. Los vSwitches especificados deben pertenecer a la misma VPC que el grupo de escalado. Los vSwitches pueden abarcar varias zonas. La prioridad de los vSwitches se ordena en orden numérico ascendente, donde 1 indica la prioridad más alta. Cuando no se puede crear una instancia de ECS en la zona de un vSwitch de mayor prioridad, el sistema selecciona automáticamente el siguiente vSwitch de mayor prioridad. |
vsw-bp1oo2a7isyrb8igf**** |
|
| LaunchTemplateOverride |
array<object> |
No |
La información de anulación de la plantilla de lanzamiento. |
|
|
object |
No |
La información de anulación de la plantilla de lanzamiento. |
||
| InstanceType |
string |
No |
Para escalar el grupo de escalado según la capacidad de los tipos de instancia, especifique tanto este parámetro como LaunchTemplateOverride.N.WeightedCapacity. Este parámetro especifica el tipo de instancia, que anula el tipo de instancia en la plantilla de lanzamiento. Puede especificar N valores para este parámetro para extender la plantilla de lanzamiento y admitir N tipos de instancia. Valores válidos de N: 1 a 20. Nota
Este parámetro solo surte efecto cuando el parámetro LaunchTemplateId especifica una plantilla de lanzamiento. Valores válidos de InstanceType: tipos de instancia de ECS disponibles para su compra. Para obtener más información, consulte Familias de instancias. |
ecs.c5.xlarge |
| WeightedCapacity |
integer |
No |
Para escalar el grupo de escalado según la capacidad de los tipos de instancia, especifique este parámetro después de especificar LaunchTemplateOverride.N.InstanceType. Los dos parámetros se corresponden entre sí de uno a uno, y los valores de N deben ser los mismos. Este parámetro especifica el peso del tipo de instancia, que representa la capacidad de una sola instancia de este tipo en el grupo de escalado. Un peso mayor significa que se requieren menos instancias de este tipo para cumplir con la capacidad esperada. Dado que los tipos de instancia difieren en métricas de rendimiento como el número de vCPU y el tamaño de memoria, puede asignar diferentes pesos a diferentes tipos de instancia según sus requisitos. Ejemplo:
Para cumplir con la capacidad esperada, el grupo de escalado escala horizontalmente dos instancias ecs.c5.xlarge. Nota
Durante el escalado horizontal, la capacidad del grupo de escalado no puede superar la suma de MaxSize y el peso máximo de los tipos de instancia. Valores válidos de WeightedCapacity: 1 a 500. |
4 |
| SpotPriceLimit |
number |
No |
El precio máximo de puja para el tipo de instancia especificado por Nota
Este parámetro solo surte efecto cuando el parámetro |
0.025 |
| AzBalance |
boolean |
No |
Especifica si se debe distribuir uniformemente la capacidad del grupo de escalado entre varias zonas. Este parámetro solo surte efecto cuando el parámetro
Valor predeterminado: false. |
false |
| AllocationStrategy |
string |
No |
La estrategia de asignación de capacidad que determina cómo el grupo de escalado selecciona los tipos de instancia disponibles para cumplir con los requisitos de capacidad. La estrategia de asignación de capacidad se aplica tanto a la capacidad de pago por uso como a la spot. Este parámetro solo surte efecto cuando el parámetro
Valor predeterminado: priority. |
priority |
| SpotAllocationStrategy |
string |
No |
La estrategia de asignación de capacidad spot. Puede utilizar este parámetro para especificar por separado la estrategia de asignación para la capacidad spot. Este parámetro solo surte efecto cuando el parámetro
Valor predeterminado: priority. |
lowestPrice |
| MaxInstanceLifetime |
integer |
No |
La cantidad máxima de tiempo que una instancia puede permanecer en el grupo de escalado. Unidad: segundos. Valores válidos: 0 o Valor predeterminado: null. Nota
Este parámetro no es compatible con los grupos de escalado de tipo ECI ni con los grupos de escalado que tienen habilitado el modo económico. |
86400 |
| CustomPolicyARN |
string |
No |
El Alibaba Cloud Resource Name (ARN) de la política de reducción personalizada (Function). Este parámetro solo surte efecto cuando la primera política de reducción en RemovalPolicies se establece en CustomPolicy. |
acs:fc:cn-zhangjiakou:16145688****:services/ess_custom_terminate_policy.LATEST/functions/ess_custom_terminate_policy_name |
| DisableDesiredCapacity |
boolean |
No |
Especifica si se debe deshabilitar la función de número esperado de instancias para el grupo de escalado. Valores válidos:
Nota
Solo puede establecer este parámetro en true cuando no hay ninguna actividad de escalado en curso en el grupo de escalado. Cuando se deshabilita la función de número esperado de instancias, se borra el atributo |
false |
| ScalingPolicy |
string |
No |
El modo de recuperación del grupo de escalado. Valores válidos:
ScalingPolicy especifica el modo de recuperación del grupo de escalado. Sin embargo, la acción específica que se realiza cuando se elimina una instancia del grupo de escalado está determinada por el parámetro RemovePolicy de RemoveInstances. Para obtener más información, consulte RemoveInstances. |
recycle |
| HealthCheckTypes |
array |
No |
Los modos de comprobación de estado del grupo de escalado. Nota
Puede especificar varios valores para este parámetro para habilitar múltiples opciones de comprobación de estado. Si se establece el parámetro |
|
|
string |
No |
La lista de modos de comprobación de estado para el grupo de escalado. Valores válidos:
Valor predeterminado: ECS. |
ECS |
|
| StopInstanceTimeout |
integer |
No |
El periodo de tiempo de espera para que una instancia de ECS se detenga durante un proceso de reducción. Unidad: segundos. Valores válidos: 30 a 240. Nota
|
60 |
| CapacityOptions |
object |
No |
Las opciones de capacidad. |
|
| OnDemandBaseCapacity |
integer |
No |
El número mínimo de instancias de pago por uso requeridas en el grupo de escalado. Cuando el número de instancias de pago por uso en el grupo de escalado es menor que este valor, el sistema crea preferentemente instancias de pago por uso. Valores válidos: 0 a 1000. Cuando el parámetro |
30 |
| OnDemandPercentageAboveBaseCapacity |
integer |
No |
El porcentaje de instancias de pago por uso entre las instancias excedentes después de cumplir con el número mínimo de instancias de pago por uso ( Cuando el parámetro |
20 |
| CompensateWithOnDemand |
boolean |
No |
Especifica si se deben crear automáticamente instancias de pago por uso para cumplir con el número requerido de instancias de ECS cuando no se pueden crear instancias spot debido a razones como el costo o un inventario insuficiente. Este parámetro solo surte efecto cuando el parámetro
|
true |
| SpotAutoReplaceOnDemand |
boolean |
No |
Especifica si se deben utilizar instancias spot para reemplazar las instancias de pago por uso cuando
Valor predeterminado: false. |
true |
| PriceComparisonMode |
string |
No |
El modo de comparación de precios para la estrategia de optimización de costos del grupo de escalado. Valores válidos:
Valor predeterminado: PricePerUnit. |
PricePerUnit |
| BalanceMode |
string |
No |
El modo de equilibrio de zonas. Este parámetro solo surte efecto cuando el equilibrio de zonas está habilitado. Valores válidos:
Valor predeterminado: BalancedBestEffort. |
BalancedBestEffort |
| AutoRebalance |
boolean |
No |
Especifica si se debe habilitar el reequilibrio automático para el grupo de escalado. Este parámetro solo surte efecto cuando BalancedOnly está habilitado para un grupo de escalado con equilibrio de zonas. Valores válidos:
Valor predeterminado: false. |
false |
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.