Esta página proporciona una referencia de las acciones de AWS Auto Scaling disponibles en el catálogo de acciones de automatización de flujo de trabajo. Utilice estas acciones para administrar los grupos de Auto Scaling (ASG) —asociar y desasociar instancias, ajustar la capacidad, ejecutar políticas de escalado, administrar las actualizaciones de instancias, controlar los procesos de escalado y consultar el estado de los ASG.
Requisitos previos
Para los requisitos previos y la configuración de credenciales, consulte Configurar las credenciales de AWS.
Adjuntar instancias
El identificador de la acción es aws.autoscaling.attachInstances.
Adjunte una o más instancias EC2 a un grupo de Auto Scaling existente. Adjuntar instancias aumenta la capacidad deseada en el número adjuntado. Puede adjuntar hasta 20 instancias por llamada. Las instancias deben estar en estado de ejecución o detenidas, y al adjuntarlas no se debe exceder el tamaño máximo del grupo.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling. |
|
instanceIds | Lista | Requerido. ID de la instancia EC2 para adjuntar. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Objeto de respuesta de la API de AWS. Consulte attach_instances — Boto3 documentation para ver la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo asocia una instancia EC2 a un grupo de Auto Scaling.
Ejemplo de flujo de trabajo |
|---|
|
Desvincular instancias
El identificador de la acción es aws.autoscaling.detachInstances.
Desvincule una o más instancias EC2 de un grupo de Auto Scaling. Puede desvincular hasta 20 instancias por llamada. Las instancias deben estar en estado InService o Standby. Si shouldDecrementDesiredCapacity es false, el ASG realiza el lanzamiento de instancias de reemplazo para mantener la capacidad deseada.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling. |
|
instanceIds | Lista | Requerido. ID de las instancias EC2 a desasociar. |
|
shouldDecrementDesiredCapacity | Booleano | Requerido. Si es
, reduce la capacidad deseada en la cantidad de instancias desconectadas. Si es
, el ASG realiza el lanzamiento de reemplazos. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Objeto de respuesta de la API de AWS. Consulte detach_instances — documentación de Boto3 para ver la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo separa una instancia y disminuye la capacidad deseada.
Ejemplo de flujo de trabajo |
|---|
|
Establecer la capacidad deseada
El identificador de la acción es aws.autoscaling.setDesiredCapacity.
Actualice el recuento de instancias deseado de un grupo de Auto Scaling. El nuevo valor debe estar entre MinSize y MaxSize del grupo. Si honorCooldown es true, la solicitud se rechaza cuando el ASG se encuentra en su período de enfriamiento.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling. |
|
desiredCapacity | En t | Requerido. Número objetivo de instancias. Debe estar entre
y
del grupo. |
|
honorCooldown | Booleano | Opcional. Si es
, rechaza la solicitud cuando el ASG está en un período de enfriamiento. Por defecto es
. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Objeto de respuesta de la API de AWS. Consulte set_desired_capacity — Boto3 documentation para ver la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo establece la capacidad deseada en 5 instancias.
Ejemplo de flujo de trabajo |
|---|
|
Ejecutar una política de escalado
El identificador de la acción es aws.autoscaling.executePolicy.
Ejecute una política de escalado con nombre en un grupo de Auto Scaling. La política ya debe existir en el grupo. Para las políticas de escalado por pasos, metricValue y breachThreshold pueden anular los umbrales de la política. Si honorCooldown es true y el ASG está en periodo de recuperación, la llamada se realiza correctamente, pero no se desencadena ninguna actividad de escalado.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling. |
|
policyName | Cadena | Requerido. Nombre o ARN de la política de escalado a ejecutar. |
|
honorCooldown | Booleano | Opcional. Si
y el ASG está en cooldown, la llamada se realiza correctamente, pero no se desencadena ninguna actividad de escalado. |
|
metricValue | Cadena | Opcional. Anulación del valor de la métrica para políticas de escalado por pasos. |
|
breachThreshold | Cadena | Opcional. Anulación del umbral de incumplimiento para las políticas de escalado por pasos. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Objeto de respuesta de la API de AWS. Consulte execute_policy — Boto3 documentation para ver la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo ejecuta una política de escalamiento horizontal con nombre.
Ejemplo de flujo de trabajo |
|---|
|
Iniciar una actualización de instancia
El identificador de la acción es aws.autoscaling.startInstanceRefresh.
Inicie un reemplazo continuo de instancias utilizando la última plantilla de lanzamiento o configuración. Solo puede haber una actualización activa por grupo a la vez —si ya hay una en curso, la llamada falla con InstanceRefreshInProgress. Utilice aws.autoscaling.describeInstanceRefreshes para sondear el estado.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling. |
|
estrategia | Cadena | Opcional. Estrategia de actualización.
es el único valor admitido. |
|
preferencias | Mapa | Opcional. Preferencias de actualización.
controla cuántas instancias permanecen en buen estado durante el reemplazo (por defecto 90 %).
establece cuánto tiempo esperar después de que una instancia alcance
antes de reemplazar el siguiente lote. |
|
desiredConfiguration | Mapa | Opcional. Anule la plantilla de lanzamiento o la configuración para esta actualización. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Contiene
(UUID de cadena) que identifica la actualización. Consulte start_instance_refresh — Boto3 documentation para ver la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo inicia una actualización continua de instancias con un mínimo del 90 % de instancias en buen estado.
Ejemplo de flujo de trabajo |
|---|
|
Cancelar una actualización de instancia
El identificador de la acción es aws.autoscaling.cancelInstanceRefresh.
Cancelar una actualización de instancia en curso. Solo se puede cancelar una actualización en curso —llamar a esto cuando no hay ninguna actualización activa falla con ActiveInstanceRefreshNotFound. Las instancias ya reemplazadas no se revierten; utilice aws.autoscaling.rollbackInstanceRefresh para revertir las instancias reemplazadas.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Contiene
de la actualización cancelada. Consulte cancel_instance_refresh — Boto3 documentation para obtener la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo cancela una actualización de instancia en curso.
Ejemplo de flujo de trabajo |
|---|
|
Revertir una actualización de instancia
El identificador de la acción es aws.autoscaling.rollbackInstanceRefresh.
Revierta una actualización de instancia en curso, devolviendo las instancias reemplazadas a su plantilla de lanzamiento o configuración anterior. El grupo debe tener un punto de control habilitado para admitir la reversión. Si ninguna actualización es elegible para la reversión, la llamada falla con ActiveInstanceRefreshNotFound.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Contiene
de la actualización revertida. Consulte rollback_instance_refresh — Boto3 documentation para obtener la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo revierte una actualización de instancia en curso.
Ejemplo de flujo de trabajo |
|---|
|
Suspender procesos de escalamiento
El identificador de la acción es aws.autoscaling.suspendProcesses.
Suspenda uno o más procesos de escalado para un grupo de Auto Scaling. Úselo durante el despliegue o las ventanas de mantenimiento para evitar la actividad de escalado no deseada. Si omite scalingProcesses, se suspenden todos los procesos. Los procesos suspendidos permanecen suspendidos hasta que se reanuden explícitamente con aws.autoscaling.resumeProcesses.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling. |
|
scalingProcesses | Lista | Opcional. Procesos para suspender. Omita para suspender todos los procesos. Valores válidos:
,
,
,
,
,
,
,
,
. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Objeto de respuesta de la API de AWS. Consulte suspend_processes — Boto3 documentation para obtener la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo suspende los procesos de lanzamiento, terminación y comprobación de estado antes de un despliegue.
Ejemplo de flujo de trabajo |
|---|
|
Reanudar procesos de escalado
El identificador de la acción es aws.autoscaling.resumeProcesses.
Reanude uno o más procesos de escalado suspendidos. Úselo después de los despliegues o las ventanas de mantenimiento para restaurar el comportamiento de escalado normal. Si omite scalingProcesses, se reanudan todos los procesos suspendidos. Si no hay procesos suspendidos actualmente, la llamada se realiza correctamente sin ningún efecto.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling. |
|
scalingProcesses | Lista | Opcional. Procesos a reanudar. Omitir para reanudar todos los procesos suspendidos. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Objeto de respuesta de la API de AWS. Consulte resume_processes — Documentación de Boto3 para ver la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo reanuda los procesos de escalado después de un despliegue.
Ejemplo de flujo de trabajo |
|---|
|
Terminar una instancia en un grupo
El identificador de la acción es aws.autoscaling.terminateInstanceInAutoScalingGroup.
Termine una instancia específica en un grupo de Auto Scaling respetando los enlaces de ciclo de vida. Establezca shouldDecrementDesiredCapacity en false para reemplazar la instancia automáticamente, o true para reducir el grupo.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
instanceId | Cadena | Requerido. ID de la instancia EC2 que se va a terminar. |
|
shouldDecrementDesiredCapacity | Booleano | Requerido. Si es
, reduce la capacidad deseada en 1. Si es
, se realiza el lanzamiento de una instancia de reemplazo automáticamente. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Contiene un objeto
con
,
y
. Consulte terminate_instance_in_auto_scaling_group — Boto3 documentation para obtener la sintaxis de respuesta completa. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo termina una instancia en mal estado y realiza el lanzamiento de un reemplazo.
Ejemplo de flujo de trabajo |
|---|
|
Mover instancias a modo de espera
El identificador de la acción es aws.autoscaling.enterStandby.
Mueva una o más instancias al modo de espera, sacándolas de la rotación activa sin terminarlas. Úselo para mantenimiento en instancias específicas. Combínelo con aws.autoscaling.exitStandby para devolver las instancias al servicio.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling. |
|
instanceIds | Lista | Opcional. ID de la instancia para mover a espera. Omítalo para mover todas las instancias. |
|
shouldDecrementDesiredCapacity | Booleano | Requerido. Si
, reduce la capacidad deseada en el número de instancias que entran en modo de espera. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Contiene una matriz
que describe la transición al modo de espera de cada instancia. Consulte enter_standby — Boto3 documentation para ver la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo mueve una instancia a espera por mantenimiento.
Ejemplo de flujo de trabajo |
|---|
|
Salir del modo de espera
El identificador de la acción es aws.autoscaling.exitStandby.
Devuelve una o más instancias del modo de espera a la rotación activa. Úselo junto con aws.autoscaling.enterStandby una vez finalizado el mantenimiento. Si omite instanceIds, todas las instancias en espera vuelven al servicio.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling. |
|
instanceIds | Lista | Opcional. ID de la instancia a devolver a la rotación activa. Omitir para sacar todas las instancias del modo de espera. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Contiene una matriz
que describe el regreso al servicio de cada instancia. Consulte exit_standby — Boto3 documentation para obtener la sintaxis de respuesta completa. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo devuelve una instancia del modo de espera después del mantenimiento.
Ejemplo de flujo de trabajo |
|---|
|
Crear o actualizar una acción programada
El identificador de la acción es aws.autoscaling.putScheduledUpdateGroupAction.
Cree o actualice una acción de escalado programada para un grupo de Auto Scaling. Use recurrence para programaciones basadas en cron o startTime para cambios de una sola vez. Combínelo con aws.autoscaling.deleteScheduledAction para eliminar acciones.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling. |
|
scheduledActionName | Cadena | Requerido. Nombre de la acción programada a crear o actualizar. |
|
startTime | Cadena | Opcional. timestamp UTC ISO 8601 para cuando la acción entra en vigor. |
|
endTime | Cadena | Opcional. Timestamp UTC ISO 8601 para cuando se detiene la acción recurrente. |
|
recurrencia | Cadena | Opcional. Expresión cron para programaciones recurrentes. |
|
timeZone | Cadena | Opcional. Zona horaria de IANA para la expresión cron de recurrencia. |
|
minSize | En t | Opcional. Tamaño mínimo del grupo a aplicar en el momento programado. |
|
maxSize | En t | Opcional. Tamaño máximo del grupo que se aplicará en la hora programada. |
|
desiredCapacity | En t | Opcional. Capacidad deseada que se aplicará a la hora programada. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Objeto de respuesta de la API de AWS. Consulte put_scheduled_update_group_action — Documentación de Boto3 para ver la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo crea una acción de reducción de escala nocturna.
Ejemplo de flujo de trabajo |
|---|
|
Eliminar una acción programada
El identificador de la acción es aws.autoscaling.deleteScheduledAction.
Eliminar una acción de escalado programada de un grupo de Auto Scaling. Solo se puede eliminar una acción por llamada. Si el nombre de la acción no existe, la llamada falla con ValidationError. Eliminar una acción no afecta ninguna actividad de escalado que ya esté en curso.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling. |
|
scheduledActionName | Cadena | Requerido. Nombre de la acción programada para eliminar. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Objeto de respuesta de la API de AWS. Consulte delete_scheduled_action — Boto3 documentation para ver la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo elimina una acción de escalado programada.
Ejemplo de flujo de trabajo |
|---|
|
Actualizar un grupo de Auto Scaling
El identificador de la acción es aws.autoscaling.updateAutoScalingGroup.
Actualice la configuración de un grupo de Auto Scaling existente —tamaño mínimo/máximo, capacidad deseada, configuración de comprobación de estado, plantilla de lanzamiento y más. Utilice el mapa parameters para pasar cualquier campo adicional de la API update_auto_scaling_group de boto3 que no aparezca a continuación.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling que se va a actualizar. |
|
minSize | En t | Opcional. Nuevo tamaño mínimo del grupo. |
|
maxSize | En t | Opcional. Nuevo tamaño máximo del grupo. |
|
desiredCapacity | En t | Opcional. Nuevo recuento de instancias deseado. |
|
defaultCooldown | En t | Opcional. Período de recuperación predeterminado en segundos. |
|
healthCheckType | Cadena | Opcional. Tipo de check de salud. Valores permitidos:
,
. |
|
healthCheckGracePeriod | En t | Opcional. Segundos después del lanzamiento de la instancia antes de que comiencen las comprobaciones de estado. |
|
parámetro | Mapa | Opcional. Cualquier campo adicional de boto3
que no aparezca en la lista anterior. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Objeto de respuesta de la API de AWS. Consulte update_auto_scaling_group — Boto3 documentation para ver la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo actualiza los límites mín./máx., el tipo de comprobación de estado y la plantilla de lanzamiento.
Ejemplo de flujo de trabajo |
|---|
|
Describir grupos de Auto Scaling
El identificador de la acción es aws.autoscaling.describeAutoScalingGroups.
Describe uno o más grupos de Auto Scaling, devolviendo la configuración y el estado de la instancia. Si omite autoScalingGroupNames, se devuelven todos los grupos de la región. Utilice maxRecords y nextToken para paginar conjuntos de resultados grandes.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupNames | Lista | Opcional. Nombres de los grupos a describir. Omítalo para devolver todos los grupos de la región. |
|
maxRecords | En t | Opcional. Número máximo de grupos a devolver. Máximo 100. |
|
nextToken | Cadena | Opcional. Token de paginación de una respuesta anterior. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Contiene una matriz
con la configuración y el estado de la instancia para cada grupo. Consulte describe_auto_scaling_groups — Boto3 documentation para obtener la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo recupera la capacidad deseada, el mínimo, el máximo y el recuento de instancias de un grupo.
Ejemplo de flujo de trabajo |
|---|
|
Describir las actualizaciones de instancias
El identificador de la acción es aws.autoscaling.describeInstanceRefreshes.
Describe el estado de una o más actualizaciones de instancia para un grupo de Auto Scaling. Úselo para sondear una actualización iniciada por aws.autoscaling.startInstanceRefresh. Si omite instanceRefreshIds, se devuelven todas las actualizaciones del grupo, las más recientes primero. Las actualizaciones completadas, canceladas y fallidas se conservan en el historial.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Requerido. Nombre del grupo de Auto Scaling. |
|
instanceRefreshIds | Lista | Opcional. ID de las actualizaciones específicas a describir. Omitir para obtener todas las actualizaciones del grupo. |
|
maxRecords | En t | Opcional. Número máximo de actualizaciones a devolver. Predeterminado 50, máx. 100. |
|
nextToken | Cadena | Opcional. Token de paginación de una respuesta anterior. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Contiene una matriz
con
,
y otros detalles de actualización. Consulte describe_instance_refreshes — documentación de Boto3 para ver la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo sondea el estado de una actualización iniciada en un paso anterior.
Ejemplo de flujo de trabajo |
|---|
|
Describir actividades de escalado
El identificador de la acción es aws.autoscaling.describeScalingActivities.
Describe las actividades de escalado de un grupo de Auto Scaling, incluidos los eventos en curso y completados recientemente. Si omite activityIds, se devuelven todas las actividades del grupo, las más recientes primero. Las actividades incluyen eventos de reducción y escalado tanto exitosos como fallidos.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Opcional. Nombre del grupo a consultar. Omitir para devolver las actividades de todos los grupos. |
|
activityIds | Lista | Opcional. ID de actividades específicas a devolver. |
|
includeDeletedGroups | Booleano | Opcional. Si es
, incluye actividades de grupos eliminados. |
|
maxRecords | En t | Opcional. Número máximo de actividades a devolver. Máximo 100. |
|
nextToken | Cadena | Opcional. Token de paginación de una respuesta anterior. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Contiene una matriz
con
,
,
y campos de tiempo. Consulte describe_scaling_activities — Boto3 documentation para obtener la sintaxis de respuesta completa. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo recupera las 5 actividades de escalado más recientes.
Ejemplo de flujo de trabajo |
|---|
|
Describir acciones programadas
El identificador de la acción es aws.autoscaling.describeScheduledActions.
Describa las acciones de escalado programadas para un grupo de Auto Scaling. Si omite scheduledActionNames, se devuelven todas las acciones del grupo. Filtrar por startTime y endTime para limitar los resultados a un intervalo de tiempo —estos filtros se ignoran cuando se proporciona scheduledActionNames.
La siguiente tabla describe todos los campos de entrada disponibles para esta acción.
Aporte | Tipo | Descripción | Ejemplo |
|---|---|---|---|
awsRoleArn | Cadena | Opcional. ARN del rol de IAM. El ejecutor asume este rol a través de STS para autenticarse con AWS. Recomendado en lugar de credenciales estáticas. Se requiere al menos un campo de autenticación. |
|
awsAccessKeyId | Cadena | Opcional. ID de clave de acceso de AWS. Debe pasarse como una referencia secreta. |
|
awsSecretAccessKey | Cadena | Opcional. Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta. |
|
awsSessionToken | Cadena | Opcional. Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta. |
|
región | Cadena | Requerido. Región de AWS donde se encuentra el grupo de Auto Scaling. |
|
autoScalingGroupName | Cadena | Opcional. Nombre del grupo a consultar. Omítalo para listar las acciones en todos los grupos. |
|
scheduledActionNames | Lista | Opcional. Nombres de las acciones específicas para devolver. Los nombres desconocidos se ignoran silenciosamente. |
|
startTime | Cadena | Opcional. Límite inferior del timestamp UTC ISO 8601 para filtrar resultados. |
|
endTime | Cadena | Opcional. Límite superior del timestamp UTC ISO 8601 para filtrar los resultados. |
|
maxRecords | En t | Opcional. Número máximo de acciones a devolver. Máximo 100. |
|
nextToken | Cadena | Opcional. Token de paginación de una respuesta anterior. |
|
selectors | Lista | Opcional. Selectores JQ para extraer campos específicos de la salida de la acción. |
|
La siguiente tabla describe todos los campos de salida devueltos por esta acción.
Producción | Tipo | Descripción |
|---|---|---|
response | Objeto | Contiene una matriz
con los campos name, recurrence, timezone y capacity para cada acción. Consulte describe_scheduled_actions — Boto3 documentation para ver la sintaxis completa de la respuesta. |
success | Booleano |
si la acción se realizó correctamente,
de lo contrario. |
errorMessage | Cadena | Mensaje de error si la acción falló.
en caso de éxito. |
El siguiente ejemplo enumera todas las acciones programadas para un grupo.
Ejemplo de flujo de trabajo |
|---|
|