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

Activa el escalado elástico según una regla de ajuste especificada.

Descripción de la operación

Antes de llamar a esta operación, asegúrese de que se cumplen las siguientes condiciones:
- El grupo de escalado está en estado Active.
- No hay ninguna actividad de escalado en curso en el grupo de escalado.
Si no hay ninguna actividad de escalado en curso en el grupo de escalado, esta operación puede omitir el tiempo de enfriamiento y activar directamente una actividad de escalado.
Si la suma del número de instancias ECS que se van a agregar según la regla de escalado más el número actual de instancias en el grupo de escalado (Total Capacity) es mayor que el número máximo de instancias (MaxSize), la actividad de escalado se realiza con Total Capacity establecido en MaxSize.
Si el número actual de instancias en el grupo de escalado (Total Capacity) menos el número de instancias ECS que se van a eliminar según la regla de escalado es menor que el número mínimo de instancias (MinSize), la actividad de escalado se realiza con Total Capacity establecido en MinSize.

Una respuesta exitosa solo indica que Auto Scaling ha aceptado la solicitud y puede realizar la actividad de escalado. Esto no significa que la actividad de escalado vaya a tener éxito. Puede verificar el estado de ejecución de la actividad de escalado mediante el ScalingActivityId devuelto.

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

update

*ScalingGroup

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ScalingGroupId	string	Sí	El ID del grupo de escalado.	asg-j6c1o397427hyjdc****
AdjustmentType	string	Sí	El método de ajuste de la actividad de escalado. 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 especificado.	QuantityChangeInCapacity
AdjustmentValue	integer	Sí	El valor de ajuste de la actividad de escalado. El número de instancias ECS ajustadas en una sola actividad de escalado no puede exceder 1000. De lo contrario, el ajuste falla. Valores válidos para los diferentes métodos de ajuste: QuantityChangeInCapacity: de -1000 a 1000. PercentChangeInCapacity: de -100 a 10000. TotalCapacity: de 0 a 2000.	100
MinAdjustmentMagnitude	integer	No	El número mínimo de instancias que se deben ajustar en una actividad de escalado. Este parámetro solo surte efecto cuando `AdjustmentType` se establece en `PercentChangeInCapacity`.	1
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud y evitar envíos repetidos. El valor lo genera el cliente y debe ser único en todas las solicitudes. El valor puede tener hasta 64 caracteres ASCII y no puede contener caracteres que no sean ASCII.	123e4567-e89b-12d3-a456-42665544****
SyncActivity	boolean	No	Especifica si se debe ejecutar sincrónicamente la actividad de escalado. Este parámetro solo es válido para grupos de escalado que tienen configurado el número esperado de instancias. Valores válidos: true: ejecución síncrona. La regla de escalado activa directamente la actividad de escalado del grupo de escalado. false: ejecución asíncrona. Cuando se modifica el número esperado de instancias en el grupo de escalado, la actividad de escalado no se activa inmediatamente. El sistema espera hasta detectar una diferencia entre el número esperado de instancias y el número actual de instancias en el grupo de escalado, y luego activa la actividad de escalado. Nota Para obtener más información sobre el número esperado de instancias, consulte Número esperado de instancias. Valor predeterminado: false.	false
Overrides	object	No	Los parámetros de anulación para el escalado horizontal en grupos de escalado de tipo ECI.
Cpu	number	No	El número de vCPU a nivel de instancia. Unidad: núcleos.	2
Memory	number	No	El tamaño de memoria a nivel de instancia. Unidad: GiB.	4
UserData	string	No
ContainerOverride	array<object>	No	Los parámetros de anulación para la lista de contenedores.
	array<object>	No	Los parámetros de anulación para la lista de contenedores.
Command	array	No	Los comandos de inicio del contenedor. Se admiten un máximo de 20 comandos. Cada comando puede contener hasta 256 caracteres.
	string	No	Los comandos de inicio del contenedor. Se admiten un máximo de 20 comandos. Cada comando puede contener hasta 256 caracteres.	sleep
Memory	number	No	El tamaño de memoria del contenedor. Unidad: GiB.	4
Arg	array	No	Los argumentos para los comandos de inicio del contenedor. Se admiten un máximo de 10 argumentos.
	string	No	Los argumentos para los comandos de inicio del contenedor. Se admiten un máximo de 10 argumentos.	arg
Cpu	number	No	El número de vCPU del contenedor. Unidad: núcleos.	2
EnvironmentVar	array<object>	No	La lista de información de variables de entorno.
	object	No	La lista de información de variables de entorno.
Value	string	No	El valor de la variable de entorno. El valor puede tener de 0 a 256 caracteres de longitud.	/usr/local/tomcat
Key	string	No	El nombre de la variable de entorno. El nombre debe tener de 1 a 128 caracteres de longitud. El nombre debe coincidir con el formato `[0-9a-zA-Z]` y puede contener guiones bajos (_). No puede comenzar con un dígito.	PATH
Name	string	No	El nombre del contenedor. Si desea anular parámetros del contenedor, debe especificar el nombre del contenedor. Los parámetros del contenedor solo se pueden anular cuando el nombre del contenedor coincide con el nombre del contenedor en la configuración de escalado.	container-1
LifecycleHookContext	object	No	La información de contexto del gancho de ciclo de vida.
DisableLifecycleHook	boolean	No	Especifica si se deben deshabilitar todas las funciones de ganchos de ciclo de vida para la actividad de escalado. Valores válidos: true: deshabilitado. false: no deshabilitado.	false
IgnoredLifecycleHookIds	array	No	La lista de ID de ganchos de ciclo de vida que se deben deshabilitar para la actividad de escalado.
	string	No	La lista de ID de ganchos de ciclo de vida que se deben deshabilitar para la actividad de escalado.	ash-bp14zolna43z266bq***
LifecycleHookResult	string	No
ActivityMetadata	string	No	Los metadatos de la actividad de escalado.	{"key":"value"}
ExecutionMode	string	No	El modo de ejecución. Valores válidos: None: no especificado. Se realiza un escalado normal. PlanOnly: no se activa el escalado. Solo se realiza la planificación elástica y los resultados de la planificación se devuelven en PlanResult, incluido el tipo de instancia, el ID de zona, el método de facturación y el número de instancias que se van a crear. Valor predeterminado: None.	PlanOnly

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta para activar el escalado elástico según una regla de ajuste especificada.
ScalingActivityId	string	El ID de la actividad de escalado.	asa-bp175o6f6ego3r2j****
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
ActivityType	string	El tipo de la actividad de escalado. Si `ActivityType` se establece en `CapacityChange`, la actividad de escalado correspondiente al `ScalingActivityId` devuelto solo modifica el número esperado de instancias en el grupo de escalado sin realizar el escalado inmediatamente. Ámbito de aplicación: grupos de escalado con el número esperado de instancias configurado.	CapacityChange
PlanResult	object	Los resultados de la planificación elástica devueltos cuando ExecutionMode se establece en PlanOnly.
ResourceAllocations	array<object>	La información de asignación de recursos en los resultados de la planificación elástica.
	object
ZoneId	string	El ID de la zona.	cn-beijing-g
InstanceType	string	El tipo de instancia.	ecs.u1-c1m8.large
SpotStrategy	string	La política de apropiación de la instancia. Valores válidos: NoSpot: una instancia de pago por uso. SpotWithPriceLimit: una instancia spot con un límite de precio máximo. SpotAsPriceGo: una instancia spot con el precio de mercado en el momento de la compra.	NoSpot
Amount	integer	El número de instancias.	1
InstanceChargeType	string	El método de facturación. Valores válidos: Prepaid: suscripción. Postpaid: pago por uso.	Postpaid

Ejemplos

Respuesta exitosa

JSON Formato

{
  "ScalingActivityId": "asa-bp175o6f6ego3r2j****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ActivityType": "CapacityChange",
  "PlanResult": {
    "ResourceAllocations": [
      {
        "ZoneId": "cn-beijing-g",
        "InstanceType": "ecs.u1-c1m8.large",
        "SpotStrategy": "NoSpot",
        "Amount": 1,
        "InstanceChargeType": "Postpaid"
      }
    ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
403	Forbidden.Forbidden	Operation Forbidden

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.