Todos los productos
Search
Centro de documentos

Auto Scaling:CreateScalingGroup

Última actualización: Sep 02, 2026

Crea un grupo de escalado para ajustar automáticamente la capacidad de cómputo (el número de instancias) según los cambios del negocio y las políticas.

Descripción de la operación

Un grupo de escalado es una colección de instancias de ECS que sirven a los mismos escenarios comunes.

El número de grupos de escalado que se pueden crear en una región depende de su uso de Auto Scaling. Vaya al Centro de cuotas para ver la cuota correspondiente al número total de grupos de escalado.

Un grupo de escalado no entra en vigor inmediatamente después de su creación. Debe invocar EnableScalingGroup para habilitar el grupo de escalado antes de que pueda desencadenar actividades de escalado y ejecutar reglas de escalado.

El grupo de escalado, las instancias de Classic Load Balancer (CLB) asociadas y las instancias de ApsaraDB RDS asociadas deben estar en la misma región. Para obtener más información, consulte Regiones y zonas.

Si asocia instancias de CLB con el grupo de escalado, este agrega automáticamente las instancias de ECS que se incorporan al grupo a los grupos de servidores backend de las instancias de CLB. Puede especificar los grupos de servidores a los que se agregan las instancias de ECS. Se admiten los siguientes dos tipos de grupos de servidores:

  • Grupo de servidores predeterminado: se utiliza para aceptar solicitudes frontend. Si no se configura ningún grupo de servidores virtuales ni grupo de servidores principal/secundario para un listener, las solicitudes se reenvían de forma predeterminada a las instancias de ECS del grupo de servidores predeterminado.

  • Grupo de servicios virtual: utilice grupos de servicios virtuales cuando desee reenviar diferentes solicitudes a distintos servidores backend, o cuando desee reenviar solicitudes basándose en nombres de dominio o URL.

Nota

Si especifica tanto el grupo de servidores predeterminado como múltiples grupos de servicios virtuales, las instancias de ECS se agregan a todos estos grupos de servidores.

Después de agregar una instancia al grupo de servidores backend de una instancia de CLB, el peso predeterminado es 50. La instancia de CLB debe cumplir las siguientes condiciones:

  • La instancia de CLB debe estar en estado activo. Puede llamar a DescribeLoadBalancers para consultar el estado de la instancia de CLB especificada.

  • Las comprobaciones de estado deben estar habilitadas para todos los puertos de listener configurados en la instancia de CLB. De lo contrario, se produce un error al crear el grupo de escalado.

Si asocia grupos de servidores de Application Load Balancer (ALB), grupos de servidores de Network Load Balancer (NLB) o grupos de servidores de Gateway Load Balancer (GWLB) con el grupo de escalado, este agrega automáticamente las instancias de ECS que se incorporan al grupo como servidores backend de los grupos de servidores de ALB, NLB o GWLB para procesar las solicitudes de acceso distribuidas por las instancias de ALB, NLB o GWLB. Puede especificar varios grupos de servidores de ALB, NLB o GWLB, pero dichos grupos deben pertenecer a la misma VPC que el grupo de escalado. Para obtener más información, consulte AttachAlbServerGroups o AttachServerGroups.

Si asocia instancias de ApsaraDB RDS con el grupo de escalado, este agrega automáticamente las direcciones IP internas de las instancias de ECS que se incorporan al grupo a las listas blancas de las instancias de RDS. Las instancias de RDS deben cumplir las siguientes condiciones:

  • La instancia de RDS debe estar en estado Running. Puede llamar a DescribeDBInstances para consultar el estado de la instancia de RDS especificada.

  • El número de direcciones IP en la lista blanca de la instancia de RDS no debe exceder el límite superior. Para obtener más información, consulte Configurar una lista blanca en la documentación de ApsaraDB RDS.

Si MultiAZPolicy del grupo de escalado está configurado como COST_OPTIMIZED:

  • Cuando especifica los parámetros OnDemandBaseCapacity, OnDemandPercentageAboveBaseCapacity y SpotInstancePools, se define el método de asignación de instancias bajo la política de optimización de costos, el cual tiene prioridad durante los eventos de escala horizontal ascendente y descendente.

  • Cuando no especifica los parámetros OnDemandBaseCapacity, OnDemandPercentageAboveBaseCapacity o SpotInstancePools, la política de optimización de costos crea instancias al menor costo posible. (En este modo, no se pueden crear instancias mediante garantía de elasticidad o reserva de capacidad. No se admite la configuración del parámetro vSwitch para interfaces de red elásticas (ENI) secundarias del controlador de interfaz de red (NIC)).

Si configura etiquetas propagables para el grupo de escalado, es decir, Tags.Propagate está establecido en true:

  • Las etiquetas del grupo de escalado se propagan únicamente a las instancias recién creadas, no a las instancias que ya se encuentran en ejecución dentro del grupo.

  • Si especifica etiquetas de instancia en la configuración de escalado y elige propagar las etiquetas del grupo de escalado a la instancia, todas las etiquetas coexisten.

  • Si una etiqueta propagable en el grupo de escalado y una etiqueta en la configuración de escalado tienen la misma clave de etiqueta, el valor de la etiqueta en la configuración de escalado tiene prioridad.

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:CreateScalingGroup

create

*ScalingGroup

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

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

ScalingGroupName

string

No

El nombre del grupo de escalado. El nombre debe ser único dentro de una región.

El nombre debe tener entre 2 y 64 caracteres de longitud y puede contener letras, dígitos, guiones bajos (_), guiones (-) y puntos (.). Debe comenzar con un dígito, una letra o un carácter chino.

Valor predeterminado: el valor de ScalingGroupId.

scalinggroup****

LaunchTemplateId

string

No

El ID de la plantilla de lanzamiento desde 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:

  • Un número de versión de plantilla fijo.

  • Default: utiliza siempre la versión predeterminada de la plantilla.

  • Latest: utiliza siempre la versión más reciente de la plantilla.

Default

InstanceId

string

No

El ID de la instancia. Al crear un grupo de escalado, la información de configuración requerida se obtiene de la instancia especificada y se crea automáticamente una configuración de escalado.

i-28wt4****

RegionId

string

Sí

El ID de la región del grupo de escalado.

cn-qingdao

MinSize

integer

Sí

El número mínimo de instancias en el grupo de escalado. Cuando el número de instancias en el grupo de escalado es inferior al valor de MinSize, Auto Scaling realiza la creación automática de instancias.

Nota

El valor de MinSize debe ser menor o igual que el valor de MaxSize.

2

MaxSize

integer

Sí

El número máximo de instancias en el grupo de escalado. Cuando el número de instancias en el grupo de escalado supera el valor de MaxSize, Auto Scaling elimina instancias automáticamente.

Los valores válidos de MaxSize dependen de su uso de Auto Scaling. Vaya al Centro de cuotas para ver la cuota correspondiente al número máximo de instancias en un solo grupo de escalado.

Si la cuota correspondiente al número máximo de instancias en un solo grupo de escalado es 2000, los valores válidos de MaxSize son de 0 a 2000.

20

DefaultCooldown

integer

No

El tiempo de enfriamiento después de que se completa una actividad de escalado (agregar o eliminar instancias). Valores válidos: 0 a 86400. Unidad: segundos.

Durante el tiempo de enfriamiento, el grupo de escalado no ejecuta otras actividades de escalado. Esto aplica únicamente a las actividades de escalado desencadenadas por tareas basadas en eventos de CloudMonitor.

Valor predeterminado: 300.

300

LoadBalancerIds

string

No

Los ID de las instancias de CLB. El valor puede ser una matriz JSON que consta de múltiples ID de instancias de CLB. Separe los múltiples ID con comas (,).

El número total de instancias de CLB que se pueden asociar con un solo grupo de escalado depende de su uso de Auto Scaling. Vaya al Centro de cuotas para ver la cuota correspondiente al número total de instancias de balanceo de carga que se pueden asociar con un solo grupo de escalado.

["lb-bp1u7etiogg38yvwz****", "lb-bp168cqrux9ai9l7f****", "lb-bp1jv3m9zvj22ufxp****"]

DBInstanceIds

string

No

Los ID de las instancias de ApsaraDB RDS. El valor puede ser una matriz JSON que consta de múltiples ID de instancias de RDS. Separe los múltiples ID con comas (,).

El número total de instancias de RDS que se pueden asociar con un solo grupo de escalado depende de su uso de Auto Scaling. Vaya al Centro de cuotas para ver la cuota correspondiente al número total de instancias de RDS que se pueden asociar con un solo grupo de escalado.

["rm-bp142f86de0t7****", "rm-bp18l1z42ar4o****", "rm-bp1lqr97h4aqk****"]

RemovalPolicies

array

No

La política de filtro para la política de reducción de escala. Valores válidos:

  • OldestInstance: elimina la instancia de ECS que se agregó primero al grupo de escalado.

  • NewestInstance: elimina la instancia de ECS que se agregó más recientemente al grupo de escalado.

  • OldestScalingConfiguration: elimina la instancia de ECS creada a partir de la configuración de escalado más antigua.

  • CustomPolicy: elimina instancias de ECS basándose en una política de reducción de escala personalizada (Function).

La configuración de escalado mencionada en OldestScalingConfiguration se refiere al origen de configuración de instancias en el grupo de escalado, lo que incluye configuraciones de escalado y plantillas de lanzamiento. CustomPolicy solo se puede establecer como la primera política de reducción de escala. Cuando especifica CustomPolicy, también debe especificar el parámetro CustomPolicyARN.

Nota

La eliminación de instancias de ECS de un grupo de escalado también se ve afectada por la política de escalado (MultiAZPolicy) del grupo. Para obtener más información, consulte Configurar una política combinada para eliminar instancias.

string

No

La política de filtro para la política de reducción de escala. Valores válidos:

  • OldestInstance: elimina la instancia de ECS que se agregó primero al grupo de escalado.

  • NewestInstance: elimina la instancia de ECS que se agregó más recientemente al grupo de escalado.

  • OldestScalingConfiguration: elimina la instancia de ECS creada a partir de la configuración de escalado más antigua.

  • CustomPolicy: elimina instancias de ECS basándose en una política de reducción de escala personalizada (Function).

La configuración de escalado mencionada en OldestScalingConfiguration se refiere al origen de configuración de instancias en el grupo de escalado, lo que incluye configuraciones de escalado y plantillas de lanzamiento. CustomPolicy solo se puede establecer como la primera política de reducción de escala. Cuando especifica CustomPolicy, también debe especificar el parámetro CustomPolicyARN.

Nota

La eliminación de instancias de ECS de un grupo de escalado también se ve afectada por la política de escalado (MultiAZPolicy) del grupo. Para obtener más información, consulte Configurar una política combinada para eliminar instancias.

OldestScalingConfiguration

VSwitchId

string

No

El ID del vSwitch. Si especifica este parámetro, el tipo de red del grupo de escalado es VPC.

Nota

Si no se especifica VSwitchId ni VSwitchIds, el tipo de red del grupo de escalado será red clásica de forma predeterminada.

vsw-bp14zolna43z266bq****

MultiAZPolicy

string

No

La política de escalado para instancias de ECS en un grupo de escalado multizona. Valores válidos:

  • PRIORITY: el vSwitch especificado en primer lugar (VSwitchIds) tiene la mayor prioridad. Auto Scaling intenta preferentemente escalar instancias en la zona del vSwitch de mayor prioridad. Si el escalado falla, Auto Scaling intenta automáticamente escalar instancias en la zona del siguiente vSwitch por prioridad.

  • COST_OPTIMIZED: durante el escalado ascendente, Auto Scaling intenta crear instancias de ECS en orden ascendente según el precio unitario de vCPU. Durante el escalado descendente, Auto Scaling intenta eliminar instancias de ECS en orden descendente según el precio unitario de vCPU. Cuando la configuración de escalado especifica múltiples tipos de instancia con métodos de facturación interrumpible, se crean preferentemente instancias spot. Puede utilizar el parámetro CompensateWithOnDemand para especificar si se deben crear automáticamente instancias de pago por uso cuando no sea posible crear instancias spot debido a inventario insuficiente u otros motivos.

    Nota

    COST_OPTIMIZED solo surte efecto cuando la configuración de escalado especifica múltiples tipos de instancia o utiliza instancias spot.

  • BALANCE: las instancias de ECS se distribuyen uniformemente entre las múltiples zonas especificadas para el grupo de escalado. Si las zonas se desequilibran debido a inventario insuficiente u otros motivos, puede llamar a RebalanceInstance para reequilibrar los recursos.

    Nota

    Cuando MultiAZPolicy se establece en BALANCE, el efecto es el mismo que cuando MultiAZPolicy se establece en COMPOSABLE con AzBalance configurado como true.

  • COMPOSABLE: una política compuesta que permite personalizar la combinación de las políticas de escalado multizona anteriores. También puede especificar parámetros adicionales para un control más detallado sobre la capacidad del grupo de escalado.

Valor predeterminado: PRIORITY.

PRIORITY

HealthCheckType

string

No

El modo de comprobación de estado del grupo de escalado. Valores válidos:

  • NONE: no se realiza ninguna comprobación de estado.

  • ECS: realiza comprobaciones de estado en las instancias del grupo de escalado (tanto los grupos de escalado de tipo ECS como los de tipo ECI utilizan este valor para habilitar las comprobaciones de estado de las instancias).

  • LOAD_BALANCER: determina el estado de salud de la instancia basándose en los resultados de las comprobaciones de estado del balanceador de carga (no se admite el tipo de balanceador de carga CLB).

Valor predeterminado: ECS.

Nota

Para habilitar tanto las comprobaciones de estado de las instancias como las del balanceador de carga, utilice el parámetro HealthCheckTypes.

ECS

ScalingPolicy

string

No

Especifica el modo de revocación del grupo de escalado. Valores válidos:

  • recycle: el grupo de escalado utiliza el modo de apagado y recuperación.

  • release: el grupo de escalado utiliza el modo de liberación.

  • forcerelease: el grupo de escalado utiliza el modo de liberación forzada.
    Nota

    Si selecciona forcerelease, las instancias en estado Running se liberan forzosamente durante las actividades de reducción de escala. Liberar forzosamente una instancia equivale a una operación de apagado, lo que borra los datos temporales en la memoria y el almacenamiento de la instancia. Los datos no se pueden recuperar. Proceda con precaución.

  • forcerecycle: el grupo de escalado utiliza el modo de apagado y recuperación forzados.
    Nota

    Si selecciona forcerecycle, las instancias en estado Running se apagan forzosamente durante las actividades de reducción de escala. Apagar forzosamente una instancia equivale a una operación de apagado, lo que borra los datos temporales en la memoria y el almacenamiento de la instancia. Los datos no se pueden recuperar. Proceda con precaución.

ScalingPolicy especifica el modo de revocación del grupo de escalado, pero la acción específica cuando se elimina una instancia del grupo de escalado viene determinada por el parámetro RemovePolicy de RemoveInstances. Para obtener más información, consulte RemoveInstances.

recycle

ClientToken

string

No

Garantiza la idempotencia de la solicitud.

Genere un valor de parámetro desde su cliente que sea único para cada solicitud distinta. El valor solo puede contener caracteres ASCII y no debe exceder los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.

123e4567-e89b-12d3-a456-42665544****

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 inferior a este valor, se crean preferentemente instancias de pago por uso.

30

OnDemandPercentageAboveBaseCapacity

integer

No

El porcentaje de instancias de pago por uso entre las instancias excedentes después de alcanzar el número mínimo de instancias de pago por uso (OnDemandBaseCapacity). Valores válidos: 0 a 100.

20

SpotInstanceRemedy

boolean

No

Especifica si se debe habilitar la política de suplemento de instancias spot. Una vez habilitada esta política, cuando el grupo de Auto Scaling recibe un mensaje del sistema que indica que una instancia spot está a punto de ser recuperada, el grupo intenta crear una nueva instancia para reemplazar la instancia spot que va a 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 sea posible crear instancias spot debido a precios, inventario u otros motivos. Este parámetro solo surte efecto cuando MultiAZPolicy está configurado como COST_OPTIMIZED. Valores válidos:

  • true: permite la creación automática.

  • false: no permite la creación automática.

Valor predeterminado: true.

true

SpotInstancePools

integer

No

El número de tipos de instancia disponibles. El grupo de escalado crea instancias spot entre múltiples tipos de instancia al menor costo y de manera equilibrada. Valores válidos: 1 a 10.

5

DesiredCapacity

integer

No

El número esperado de instancias en el grupo de escalado. El grupo de escalado mantiene automáticamente el número de instancias en la cantidad esperada. El valor no debe ser mayor que MaxSize ni menor que MinSize.

5

GroupDeletionProtection

boolean

No

Especifica si se debe habilitar la protección contra eliminación para el grupo de escalado. Valores válidos:

  • true: habilita la protección contra eliminación. El grupo de escalado no se puede eliminar.

  • false: deshabilita la protección contra eliminación.

Valor predeterminado: false.

true

GroupType

string

No

El tipo de instancias administradas por el grupo de escalado. Valores válidos:

  • ECS: el grupo de escalado administra instancias de ECS.

  • ECI: el grupo de escalado administra instancias de ECI.

Valor predeterminado: ECS.

ECS

ContainerGroupId

string

No

El ID de la instancia de ECI, que corresponde al ID del grupo de contenedores.

eci-uf6fonnghi50u374****

VSwitchIds

array

No

Los ID de uno o más vSwitches. Si especifica VSwitchIds, se ignora el parámetro VSwitchId. Si especifica este parámetro, el tipo de red del grupo de escalado es VPC.

Cuando especifica múltiples vSwitches:

  • Deben pertenecer a la misma VPC.

  • Pueden pertenecer a diferentes zonas.

  • La prioridad de los vSwitches se clasifica en orden numérico ascendente, donde 1 indica la mayor prioridad. Cuando no se puede crear una instancia en la zona de un vSwitch de mayor prioridad, se selecciona automáticamente el siguiente vSwitch por prioridad.

Nota

Si no se especifica VSwitchId ni VSwitchIds, el tipo de red del grupo de escalado será red clásica de forma predeterminada.

string

No

Los ID de uno o más vSwitches. Si especifica VSwitchIds, se ignora el parámetro VSwitchId. Si especifica este parámetro, el tipo de red del grupo de escalado es VPC.

Cuando especifica múltiples vSwitches:

  • Deben pertenecer a la misma VPC.

  • Pueden pertenecer a diferentes zonas.

  • La prioridad de los vSwitches se clasifica en orden numérico ascendente, donde 1 indica la mayor prioridad. Cuando no se puede crear una instancia en la zona de un vSwitch de mayor prioridad, se selecciona automáticamente el siguiente vSwitch por prioridad.

Nota

Si no se especifica VSwitchId ni VSwitchIds, el tipo de red del grupo de escalado será red clásica de forma predeterminada.

vsw-bp14zolna43z266bq****

LifecycleHooks

array<object>

No

La lista de información de hooks de ciclo de vida.

object

No

La lista de información de hooks de ciclo de vida.

DefaultResult

string

No

La siguiente acción después de que finaliza el estado de espera. Valores válidos:

  • CONTINUE: continúa respondiendo a la actividad de escalado ascendente o continúa respondiendo a la actividad de escalado descendente.

  • ABANDON: libera la instancia creada durante la actividad de escalado ascendente, o elimina la instancia del grupo de escalado durante la actividad de escalado descendente.

Cuando una actividad de reducción de escala (SCALE_IN) desencadena múltiples hooks de ciclo de vida, si finaliza el estado de espera de un hook cuyo DefaultResult está configurado como ABANDON, los estados de espera de los demás hooks correspondientes finalizan anticipadamente. En otros casos, la siguiente acción viene determinada por el último hook de ciclo de vida cuyo estado de espera finaliza.

Valor predeterminado: CONTINUE.

CONTINUE

LifecycleHookName

string

No

El nombre del hook de ciclo de vida. Una vez especificado el nombre, no se puede modificar. Si no se especifica, el nombre toma como valor predeterminado el ID del hook de ciclo de vida.

lifecyclehook****

LifecycleTransition

string

No

El tipo de actividad de escalado a la que aplica el hook de ciclo de vida. Valores válidos:

  • SCALE_OUT: actividad de escalado ascendente del grupo de escalado.

  • SCALE_IN: actividad de escalado descendente del grupo de escalado.

Nota

Si se especifican hooks de ciclo de vida para el grupo de escalado, este parámetro es obligatorio. Otros parámetros relacionados son opcionales.

SCALE_OUT

NotificationMetadata

string

No

La información de cadena fija para el estado de espera de la actividad de escalado. El valor del parámetro no puede exceder los 4096 caracteres de longitud. Cada vez que Auto Scaling envía un mensaje al destinatario de notificaciones, también incluye el valor del parámetro notificationmetadata que usted especificó previamente, lo que le ayuda a gestionar y marcar diferentes categorías de información de notificación. Este parámetro solo surte efecto cuando también se especifica el parámetro notificationarn.

Test

NotificationArn

string

No

La identidad del destinatario de notificaciones para el hook de ciclo de vida. Se admiten los siguientes tipos de objetos de notificación: colas y temas de Simple Message Queue (anteriormente MNS). El valor del parámetro tiene el siguiente formato: acs:ess:{region}:{account-id}:{resource-relative-id}.

  • region: la región donde reside el grupo de escalado.

  • account-id: el ID de la cuenta de Alibaba Cloud.

Ejemplos:

  • Cola de MNS: acs:ess:{region}:{account-id}:queue/{queuename}.

  • Tema de MNS: acs:ess:{region}:{account-id}:topic/{topicname}.

acs:ess:cn-hangzhou:1111111111:queue/queue2

HeartbeatTimeout

integer

No

El tiempo de espera establecido por el hook de ciclo de vida para la actividad del grupo de escalado. Después de que expire el estado de espera, se ejecuta la siguiente acción. Valores válidos: 30 a 21600. Unidad: segundos.

Después de crear un hook de ciclo de vida, puede llamar a RecordLifecycleActionHeartbeat para extender el tiempo de espera de la instancia, o llamar a CompleteLifecycleAction para finalizar anticipadamente el estado de espera de la actividad de escalado.

Valor predeterminado: 600.

600

VServerGroups

array<object>

No

La información sobre los grupos de servicios virtuales asociados con el grupo de escalado.

array<object>

No

La información sobre los grupos de servicios virtuales asociados con el grupo de escalado.

VServerGroupAttributes

array<object>

No

Los atributos del grupo de servidores backend.

object

No

Los atributos del grupo de servidores backend.

VServerGroupId

string

No

El ID del grupo de servicios virtual.

rsp-bp1443g77****

Weight

integer

No

El peso de la instancia como servidor backend después de que Auto Scaling agrega la instancia al grupo de servicios virtual. Un peso mayor resulta en que se asignen más solicitudes de acceso a la instancia. Si el peso es 0, la instancia no recibe solicitudes de acceso. Valores válidos: 0 a 100.

Valor predeterminado: 50.

100

Port

integer

No

El número de puerto utilizado por la instancia después de que Auto Scaling agrega la instancia al grupo de servicios virtual. Valores válidos: 1 a 65535.

22

LoadBalancerId

string

No

El ID de la instancia de CLB (Classic Load Balancer) a la que pertenece el grupo de servicios virtual.

lb-bp1u7etiogg38yvwz****

Tags

array<object>

No

Las etiquetas del grupo de escalado.

object

No

Las etiquetas del grupo de escalado.

Key

string

No

La clave de etiqueta del grupo de escalado.

Department

Value

string

No

El valor de etiqueta del grupo de escalado.

Finance

Propagate

boolean

No

Especifica si la etiqueta es una etiqueta propagable. Valores válidos:

  • true: la etiqueta del grupo de escalado se propaga únicamente a las instancias recién creadas, no a las instancias que ya se encuentran en ejecución dentro del grupo de escalado.

  • false: la etiqueta del grupo de escalado no se propaga a las instancias.

Valor predeterminado: false.

false

LaunchTemplateOverrides

array<object>

No

La información de tipos de instancia que extiende la plantilla de lanzamiento.

object

No

La información de tipos de instancia que extiende la plantilla de lanzamiento.

InstanceType

string

No

Cuando desea que el grupo de escalado escale basándose en la capacidad del tipo de instancia, especifique tanto este parámetro como LaunchTemplateOverrides.WeightedCapacity.

Este parámetro especifica el tipo de instancia y anula el tipo de instancia definido en la plantilla de lanzamiento.

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 compra.

ecs.c5.xlarge

WeightedCapacity

integer

No

Cuando desea que el grupo de escalado escale basándose en la capacidad del tipo de instancia, especifique este parámetro después de especificar LaunchTemplateOverrides.InstanceType.

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 necesitan menos instancias de este tipo para alcanzar la capacidad esperada.

Dado que las métricas de rendimiento, como el número de vCPU y el tamaño de memoria, varían según el tipo de instancia, puede asignar diferentes pesos a distintos tipos de instancia según sus necesidades.

Ejemplos:

  • Capacidad actual: 0.

  • Capacidad esperada: 6.

  • Capacidad de ecs.c5.xlarge: 4.

Para alcanzar la capacidad esperada, el grupo de escalado escala horizontalmente creando 2 instancias ecs.c5.xlarge.

Nota

Durante el escalado ascendente, la capacidad del grupo de escalado no debe exceder la suma de la capacidad máxima (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 oferta para el tipo de instancia especificado en la anulación de la plantilla de lanzamiento (LaunchTemplateOverride.InstanceType).

Nota

Este parámetro solo surte efecto cuando el parámetro LaunchTemplateId especifica una plantilla de lanzamiento.

0.025

AlbServerGroups

array<object>

No

La información sobre los grupos de servidores ALB.

object

No

La información sobre los grupos de servidores ALB.

AlbServerGroupId

string

No

El ID del grupo de servidores ALB.

El número de grupos de servidores ALB que se pueden asociar con un grupo de escalado es limitado. Para ver o solicitar un aumento de cuota, vaya al Centro de cuotas.

sgp-ddwb0y0g6y9bjm****

Weight

integer

No

El peso de la instancia como servidor backend después de que Auto Scaling agrega la instancia al grupo de servidores ALB. Un peso mayor resulta en que se distribuyan más solicitudes de acceso a la instancia. Si el peso es 0, la instancia no recibe solicitudes de acceso. Valores válidos: 0 a 100.

100

Port

integer

No

El número de puerto utilizado por la instancia después de que Auto Scaling agrega la instancia al grupo de servidores ALB. Valores válidos: 1 a 65535.

22

ServerGroups

array<object>

No

La información sobre los grupos de servidores de balanceo de carga.

Nota

No puede especificar la misma información de grupo de servidores en AlbServerGroups y ServerGroups simultáneamente.

object

No

La información sobre los grupos de servidores de balanceo de carga.

ServerGroupId

string

No

El ID del grupo de servidores.

sgp-5yc3bd9lfyh*****

Type

string

No

El tipo de grupo de servidores. Valores válidos:

  • ALB: Application Load Balancer (ALB).

  • NLB: Network Load Balancer (NLB).

  • GWLB: Gateway Load Balancer (GWLB).

ALB

Weight

integer

No

El peso de la instancia como servidor backend después de que Auto Scaling agrega la instancia al grupo de servidores. Valores válidos: 0 a 100.

Un peso mayor resulta en que se asignen más solicitudes de acceso a la instancia. Si el peso es 0, la instancia no recibe solicitudes de acceso.

Nota

Este parámetro es obligatorio para los grupos de servidores de balanceo de carga de tipo ALB y NLB. Este parámetro no se puede configurar para los grupos de servidores de balanceo de carga de tipo GWLB.

100

Port

integer

No

El número de puerto utilizado por la instancia después de que Auto Scaling agrega la instancia al grupo de servidores. Valores válidos: 1 a 65535.

22

AzBalance

boolean

No

Especifica si la capacidad del grupo de escalado se distribuye uniformemente entre varias zonas. Este parámetro solo surte efecto cuando MultiAZPolicy se establece en COMPOSABLE. Valores válidos:

  • true: la capacidad del grupo de escalado se distribuye uniformemente entre varias zonas.

  • false: la capacidad del grupo de escalado no se distribuye uniformemente entre varias zonas.

Nota

Cuando MultiAZPolicy se establece en COMPOSABLE y AzBalance se establece en true, el efecto es el mismo que cuando MultiAZPolicy se establece en BALANCE.

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 capacidad spot. Este parámetro solo surte efecto cuando MultiAZPolicy se establece en COMPOSABLE. Valores válidos:

  • priority: crea instancias en el orden de los tipos de instancia configurados.

  • lowestPrice: crea instancias en orden ascendente según el precio unitario de vCPU.

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 MultiAZPolicy se establece en COMPOSABLE. Valores válidos:

  • priority: crea instancias en el orden de los tipos de instancia configurados.

  • lowestPrice: crea instancias en orden ascendente según el precio unitario de vCPU.

Valor predeterminado: priority.

lowestPrice

SyncAlarmRuleToCms

boolean

No

Nota

Este parámetro no está disponible para su uso.

false

MaxInstanceLifetime

integer

No

El tiempo máximo que una instancia puede existir en el grupo de escalado. Unidad: segundos.

Valores válidos: [86400, Integer.maxValue].

Valor predeterminado: null.

null

CustomPolicyARN

string

No

El nombre de recurso de Alibaba Cloud (ARN) de la política de reducción de escala personalizada (Function). Este parámetro solo surte efecto cuando la primera política de reducción de escala en RemovalPolicies se establece en CustomPolicy.

acs:fc:cn-zhangjiakou:16145688****:services/ess_custom_terminate_policy.LATEST/functions/ess_custom_terminate_policy_name

ResourceGroupId

string

No

El ID del grupo de recursos al que pertenece el grupo de escalado recién creado.

Nota

El grupo de escalado recién creado se agrega al grupo de recursos especificado. Si no especifica este parámetro, el grupo de escalado se agrega al grupo de recursos predeterminado.

rg-123******

LoadBalancerConfigs

array<object>

No

La lista de configuraciones de balanceo de carga.

object

No

La lista de configuraciones de CLB de balanceo de carga (anteriormente SLB).

LoadBalancerId

string

No

El ID de la instancia de CLB de balanceo de carga (anteriormente SLB).

lb-2zen1olhfg9yw3f4q****

Weight

integer

No

El peso de la instancia como servidor backend después de que Auto Scaling agrega la instancia al grupo de servidores SLB. Un peso mayor resulta en que se distribuyan más solicitudes de acceso a la instancia. Si el peso es 0, la instancia no recibe solicitudes de acceso. Valores válidos: 0 a 100.

10

HealthCheckTypes

array

No

Los modos de comprobación de estado del grupo de escalado.

Nota

Puede utilizar este parámetro para establecer múltiples valores y habilitar varias opciones de comprobación de estado. Si se establece el parámetro HealthCheckType, este parámetro se ignora.

string

No

La lista de modos de comprobación de estado para el grupo de escalado. Valores válidos:

  • NONE: no se realiza ninguna comprobación de estado.

  • ECS: realiza comprobaciones de estado en las instancias del grupo de escalado (tanto los grupos de escalado de tipo ECS como los de tipo ECI utilizan este valor para habilitar las comprobaciones de estado de las instancias).

  • LOAD_BALANCER: determina el estado de salud de la instancia basándose en los resultados de la comprobación de estado del balanceo de carga (no se admite el tipo de balanceo de carga CLB).

Valor predeterminado: ECS. [_single.

ECS

DBInstances

array<object>

No

La lista de bases de datos asociadas con el grupo de escalado.

object

No

La información de configuración de la base de datos asociada con el grupo de escalado.

DBInstanceId

string

No

El ID de la instancia de base de datos.

rm-m5eqju85s45mu0***

Type

string

No

El tipo de base de datos. Valores válidos:

  • RDS.

  • Redis.

  • MongoDB.

Valor predeterminado: RDS.

RDS

AttachMode

string

No

El modo de asociación entre el grupo de escalado y la base de datos. Valores válidos:

  • SecurityIp: modo de lista blanca de IP. Las instancias agregadas durante el escalado horizontal se añaden automáticamente a la lista blanca de IP de la base de datos (actualmente solo se admite ApsaraDB RDS).

  • SecurityGroup: modo de security group. El security group en la configuración de escalado se agrega a la lista blanca de security groups de la base de datos, lo que permite que las instancias del security group accedan a la base de datos.

SecurityIp

StopInstanceTimeout

integer

No

El período de tiempo de espera para que una instancia de ECS se detenga durante el proceso de reducción de escala. Unidad: segundos. Valores válidos: 30 a 240.

Nota
  • Este parámetro solo surte efecto durante el proceso de reducción de escala cuando ScalingPolicy se establece en release.

  • Si se establece este parámetro, el sistema espera hasta StopInstanceTimeout segundos a que la instancia se detenga. Después del tiempo de espera, el proceso de reducción de escala continúa independientemente de si la instancia se ha detenido o no.

  • Si no se establece este parámetro, el sistema espera indefinidamente a que la instancia se detenga. El proceso de reducción de escala continúa solo después de que la instancia se detiene. Si la instancia no logra detenerse, el proceso de reducción de escala se revierte y la reducción de escala falla.

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 existente. Cuando el número de instancias de pago por uso es menor que este valor, se crean preferentemente instancias de pago por uso. Valores válidos: 0 a 1000.

Cuando MultiAZPolicy se establece en COMPOSABLE, el valor predeterminado es 0.

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 MultiAZPolicy se establece en COMPOSABLE, el valor predeterminado es 100. [_single.params.CapacityOptions.props.CompensateWith

20

CompensateWithOnDemand

boolean

No

Especifica si se deben crear automáticamente instancias de pago por uso cuando no se pueden crear instancias spot debido a razones de precio o inventario, si MultiAZPolicy se establece en COST_OPTIMIZED. Este parámetro especifica si se permite que el sistema cree automáticamente instancias de pago por uso para cumplir con el número requerido de instancias de ECS. Valores válidos:

  • true: Permitido.

  • false: No permitido.

Valor predeterminado: true.

true

SpotAutoReplaceOnDemand

boolean

No

Especifica si se debe intentar reemplazar las instancias de pago por uso con instancias spot cuando CompensateWithOnDemand está habilitado y la proporción de pago por uso excede la proporción de OnDemandPercentageAboveBaseCapacity. Un escenario común es cuando CompensateWithOnDemand provoca que las instancias spot se degraden a instancias de pago por uso debido a razones de inventario o precio spot. Para evitar que las instancias de pago por uso persistan durante un período prolongado, el sistema intenta reemplazar la capacidad excedente de pago por uso con instancias spot. Valores válidos:

  • true: Permitido.

  • false: No permitido.

Valor predeterminado: false.

false

PriceComparisonMode

string

No

El modo de comparación de precios de la política de optimización de costos para el grupo de escalado. Valores válidos:

  • PricePerUnit: compara precios basándose en el precio por unidad de capacidad.

    La capacidad de una instancia en el grupo de escalado equivale al peso configurado para el tipo de instancia. El peso predeterminado es 1, lo que significa que una instancia de ECS ocupa una capacidad de 1.

  • PricePerVCpu: compara precios basándose en el precio por vCPU.

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:

  • BalancedBestEffort: si la creación de recursos falla en una zona, el sistema recurre a otras zonas para garantizar la entrega de recursos con el mejor esfuerzo posible.

  • BalancedOnly: si la creación de recursos falla en una zona, el sistema no recurre a otras zonas. La actividad de escalado tiene éxito parcialmente para evitar un desequilibrio excesivo de recursos entre zonas.

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:

  • false: El reequilibrio automático está deshabilitado.

  • true: Cuando el reequilibrio automático está habilitado, el grupo de escalado monitorea automáticamente la capacidad entre zonas. Si la capacidad está desequilibrada entre zonas, el sistema realiza proactivamente operaciones de escalado horizontal y reducción de escala para reequilibrar la capacidad.

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****

ScalingGroupId

string

El ID del grupo de escalado.

asg-bp14wlu85wrpchm0****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ScalingGroupId": "asg-bp14wlu85wrpchm0****"
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

404 ResourceNotAvailable.VPCNetwork The specified zone does not support vpc network or sold out.

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.