• /
  • EnglishEspañolFrançais日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Acciones de AWS Auto Scaling

|View as Markdown (English)

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling.

"my-asg"

instanceIds

Lista

Requerido.

ID de la instancia EC2 para adjuntar.

["i-0123456789abcdef0", "i-0fedcba9876543210"]

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "success", "expression": ".success"}]

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

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

en caso de éxito.

El siguiente ejemplo asocia una instancia EC2 a un grupo de Auto Scaling.

Ejemplo de flujo de trabajo

name: asg-attach-instances
workflowInputs:
arnRole:
type: String
asgName:
type: String
steps:
- name: attachInstances
type: action
action: aws.autoscaling.attachInstances
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: ${{ .workflowInputs.asgName }}
instanceIds:
- i-0123456789abcdef0
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling.

"my-asg"

instanceIds

Lista

Requerido.

ID de las instancias EC2 a desasociar.

["i-0123456789abcdef0"]

shouldDecrementDesiredCapacity

Booleano

Requerido.

Si es

true

, reduce la capacidad deseada en la cantidad de instancias desconectadas. Si es

false

, el ASG realiza el lanzamiento de reemplazos.

true

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "activities", "expression": ".response.Activities"}]

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

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

en caso de éxito.

El siguiente ejemplo separa una instancia y disminuye la capacidad deseada.

Ejemplo de flujo de trabajo

name: asg-detach-instances
workflowInputs:
arnRole:
type: String
steps:
- name: detachInstances
type: action
action: aws.autoscaling.detachInstances
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
instanceIds:
- i-0123456789abcdef0
shouldDecrementDesiredCapacity: true
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling.

"my-asg"

desiredCapacity

En t

Requerido.

Número objetivo de instancias. Debe estar entre

MinSize

y

MaxSize

del grupo.

3

honorCooldown

Booleano

Opcional.

Si es

true

, rechaza la solicitud cuando el ASG está en un período de enfriamiento. Por defecto es

false

.

false

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "success", "expression": ".success"}]

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

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

en caso de éxito.

El siguiente ejemplo establece la capacidad deseada en 5 instancias.

Ejemplo de flujo de trabajo

name: asg-set-capacity
workflowInputs:
arnRole:
type: String
steps:
- name: setDesiredCapacity
type: action
action: aws.autoscaling.setDesiredCapacity
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
desiredCapacity: 5
honorCooldown: false
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling.

"my-asg"

policyName

Cadena

Requerido.

Nombre o ARN de la política de escalado a ejecutar.

"my-scale-out-policy"

honorCooldown

Booleano

Opcional.

Si

true

y el ASG está en cooldown, la llamada se realiza correctamente, pero no se desencadena ninguna actividad de escalado.

false

metricValue

Cadena

Opcional.

Anulación del valor de la métrica para políticas de escalado por pasos.

"50.0"

breachThreshold

Cadena

Opcional.

Anulación del umbral de incumplimiento para las políticas de escalado por pasos.

"70.0"

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "success", "expression": ".success"}]

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

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

en caso de éxito.

El siguiente ejemplo ejecuta una política de escalamiento horizontal con nombre.

Ejemplo de flujo de trabajo

name: asg-execute-policy
workflowInputs:
arnRole:
type: String
steps:
- name: executePolicy
type: action
action: aws.autoscaling.executePolicy
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
policyName: my-scale-out-policy
honorCooldown: false
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling.

"my-asg"

estrategia

Cadena

Opcional.

Estrategia de actualización.

"Rolling"

es el único valor admitido.

"Rolling"

preferencias

Mapa

Opcional.

Preferencias de actualización.

MinHealthyPercentage

controla cuántas instancias permanecen en buen estado durante el reemplazo (por defecto 90 %).

InstanceWarmup

establece cuánto tiempo esperar después de que una instancia alcance

InService

antes de reemplazar el siguiente lote.

{"MinHealthyPercentage": 90, "InstanceWarmup": 300}

desiredConfiguration

Mapa

Opcional.

Anule la plantilla de lanzamiento o la configuración para esta actualización.

{"LaunchTemplate": {"LaunchTemplateId": "lt-0123456789abcdef0", "Version": "2"}}

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "instanceRefreshId", "expression": ".response.InstanceRefreshId"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Descripción

response

Objeto

Contiene

InstanceRefreshId

(UUID de cadena) que identifica la actualización. Consulte

start_instance_refresh — Boto3 documentation

para ver la sintaxis completa de la respuesta.

success

Booleano

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

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

name: asg-start-refresh
workflowInputs:
arnRole:
type: String
steps:
- name: startInstanceRefresh
type: action
action: aws.autoscaling.startInstanceRefresh
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
strategy: Rolling
preferences:
MinHealthyPercentage: 90
InstanceWarmup: 300
selectors:
- name: instanceRefreshId
expression: '.response.InstanceRefreshId'
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling.

"my-asg"

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "instanceRefreshId", "expression": ".response.InstanceRefreshId"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Descripción

response

Objeto

Contiene

InstanceRefreshId

de la actualización cancelada. Consulte

cancel_instance_refresh — Boto3 documentation

para obtener la sintaxis completa de la respuesta.

success

Booleano

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

en caso de éxito.

El siguiente ejemplo cancela una actualización de instancia en curso.

Ejemplo de flujo de trabajo

name: asg-cancel-refresh
workflowInputs:
arnRole:
type: String
steps:
- name: cancelRefresh
type: action
action: aws.autoscaling.cancelInstanceRefresh
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
selectors:
- name: instanceRefreshId
expression: '.response.InstanceRefreshId'
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling.

"my-asg"

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "instanceRefreshId", "expression": ".response.InstanceRefreshId"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Descripción

response

Objeto

Contiene

InstanceRefreshId

de la actualización revertida. Consulte

rollback_instance_refresh — Boto3 documentation

para obtener la sintaxis completa de la respuesta.

success

Booleano

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

en caso de éxito.

El siguiente ejemplo revierte una actualización de instancia en curso.

Ejemplo de flujo de trabajo

name: asg-rollback-refresh
workflowInputs:
arnRole:
type: String
steps:
- name: rollbackRefresh
type: action
action: aws.autoscaling.rollbackInstanceRefresh
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
selectors:
- name: instanceRefreshId
expression: '.response.InstanceRefreshId'
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling.

"my-asg"

scalingProcesses

Lista

Opcional.

Procesos para suspender. Omita para suspender todos los procesos. Valores válidos:

Launch

,

Terminate

,

HealthCheck

,

ReplaceUnhealthy

,

AZRebalance

,

AlarmNotification

,

ScheduledActions

,

AddToLoadBalancer

,

InstanceRefresh

.

["Launch", "Terminate", "HealthCheck"]

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "success", "expression": ".success"}]

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

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

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

name: asg-suspend-for-deploy
workflowInputs:
arnRole:
type: String
steps:
- name: suspendProcesses
type: action
action: aws.autoscaling.suspendProcesses
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
scalingProcesses:
- Launch
- Terminate
- HealthCheck
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling.

"my-asg"

scalingProcesses

Lista

Opcional.

Procesos a reanudar. Omitir para reanudar todos los procesos suspendidos.

["Launch", "Terminate", "HealthCheck"]

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "success", "expression": ".success"}]

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

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

en caso de éxito.

El siguiente ejemplo reanuda los procesos de escalado después de un despliegue.

Ejemplo de flujo de trabajo

name: asg-resume-after-deploy
workflowInputs:
arnRole:
type: String
steps:
- name: resumeProcesses
type: action
action: aws.autoscaling.resumeProcesses
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
scalingProcesses:
- Launch
- Terminate
- HealthCheck
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

instanceId

Cadena

Requerido.

ID de la instancia EC2 que se va a terminar.

"i-0123456789abcdef0"

shouldDecrementDesiredCapacity

Booleano

Requerido.

Si es

true

, reduce la capacidad deseada en 1. Si es

false

, se realiza el lanzamiento de una instancia de reemplazo automáticamente.

false

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "activityStatus", "expression": ".response.Activity.StatusCode"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Descripción

response

Objeto

Contiene un objeto

Activity

con

ActivityId

,

StatusCode

y

Progress

. Consulte

terminate_instance_in_auto_scaling_group — Boto3 documentation

para obtener la sintaxis de respuesta completa.

success

Booleano

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

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

name: asg-terminate-unhealthy-instance
workflowInputs:
arnRole:
type: String
steps:
- name: terminateInstance
type: action
action: aws.autoscaling.terminateInstanceInAutoScalingGroup
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
instanceId: i-0123456789abcdef0
shouldDecrementDesiredCapacity: false
selectors:
- name: activityStatus
expression: '.response.Activity.StatusCode'
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling.

"my-asg"

instanceIds

Lista

Opcional.

ID de la instancia para mover a espera. Omítalo para mover todas las instancias.

["i-0123456789abcdef0"]

shouldDecrementDesiredCapacity

Booleano

Requerido.

Si

true

, reduce la capacidad deseada en el número de instancias que entran en modo de espera.

true

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "activities", "expression": ".response.Activities"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Descripción

response

Objeto

Contiene una matriz

Activities

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

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

en caso de éxito.

El siguiente ejemplo mueve una instancia a espera por mantenimiento.

Ejemplo de flujo de trabajo

name: asg-enter-standby
workflowInputs:
arnRole:
type: String
steps:
- name: enterStandby
type: action
action: aws.autoscaling.enterStandby
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
instanceIds:
- i-0123456789abcdef0
shouldDecrementDesiredCapacity: true
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling.

"my-asg"

instanceIds

Lista

Opcional.

ID de la instancia a devolver a la rotación activa. Omitir para sacar todas las instancias del modo de espera.

["i-0123456789abcdef0"]

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "activities", "expression": ".response.Activities"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Descripción

response

Objeto

Contiene una matriz

Activities

que describe el regreso al servicio de cada instancia. Consulte

exit_standby — Boto3 documentation

para obtener la sintaxis de respuesta completa.

success

Booleano

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

en caso de éxito.

El siguiente ejemplo devuelve una instancia del modo de espera después del mantenimiento.

Ejemplo de flujo de trabajo

name: asg-exit-standby
workflowInputs:
arnRole:
type: String
steps:
- name: exitStandby
type: action
action: aws.autoscaling.exitStandby
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
instanceIds:
- i-0123456789abcdef0
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling.

"my-asg"

scheduledActionName

Cadena

Requerido.

Nombre de la acción programada a crear o actualizar.

"scale-down-nights"

startTime

Cadena

Opcional.

timestamp UTC ISO 8601 para cuando la acción entra en vigor.

"2024-06-01T20:00:00Z"

endTime

Cadena

Opcional.

Timestamp UTC ISO 8601 para cuando se detiene la acción recurrente.

"2024-12-31T23:59:59Z"

recurrencia

Cadena

Opcional.

Expresión cron para programaciones recurrentes.

"0 20 * * *"

timeZone

Cadena

Opcional.

Zona horaria de IANA para la expresión cron de recurrencia.

"America/New_York"

minSize

En t

Opcional.

Tamaño mínimo del grupo a aplicar en el momento programado.

1

maxSize

En t

Opcional.

Tamaño máximo del grupo que se aplicará en la hora programada.

10

desiredCapacity

En t

Opcional.

Capacidad deseada que se aplicará a la hora programada.

2

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "success", "expression": ".success"}]

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

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

en caso de éxito.

El siguiente ejemplo crea una acción de reducción de escala nocturna.

Ejemplo de flujo de trabajo

name: asg-create-scheduled-action
workflowInputs:
arnRole:
type: String
steps:
- name: putScheduledAction
type: action
action: aws.autoscaling.putScheduledUpdateGroupAction
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
scheduledActionName: scale-down-nights
recurrence: "0 20 * * *"
timeZone: America/New_York
desiredCapacity: 2
minSize: 1
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling.

"my-asg"

scheduledActionName

Cadena

Requerido.

Nombre de la acción programada para eliminar.

"scale-down-nights"

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "success", "expression": ".success"}]

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

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

en caso de éxito.

El siguiente ejemplo elimina una acción de escalado programada.

Ejemplo de flujo de trabajo

name: asg-delete-scheduled-action
workflowInputs:
arnRole:
type: String
steps:
- name: deleteScheduledAction
type: action
action: aws.autoscaling.deleteScheduledAction
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
scheduledActionName: scale-down-nights
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling que se va a actualizar.

"my-asg"

minSize

En t

Opcional.

Nuevo tamaño mínimo del grupo.

1

maxSize

En t

Opcional.

Nuevo tamaño máximo del grupo.

10

desiredCapacity

En t

Opcional.

Nuevo recuento de instancias deseado.

3

defaultCooldown

En t

Opcional.

Período de recuperación predeterminado en segundos.

300

healthCheckType

Cadena

Opcional.

Tipo de check de salud. Valores permitidos:

EC2

,

ELB

.

"ELB"

healthCheckGracePeriod

En t

Opcional.

Segundos después del lanzamiento de la instancia antes de que comiencen las comprobaciones de estado.

300

parámetro

Mapa

Opcional.

Cualquier campo adicional de boto3

update_auto_scaling_group

que no aparezca en la lista anterior.

{"LaunchTemplate": {"LaunchTemplateId": "lt-0123456789abcdef0", "Version": "$Latest"}, "TerminationPolicies": ["OldestInstance"]}

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "success", "expression": ".success"}]

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

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

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

name: asg-update-group
workflowInputs:
arnRole:
type: String
steps:
- name: updateAutoScalingGroup
type: action
action: aws.autoscaling.updateAutoScalingGroup
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
minSize: 2
maxSize: 20
desiredCapacity: 5
healthCheckType: ELB
healthCheckGracePeriod: 300
parameters:
LaunchTemplate:
LaunchTemplateId: lt-0123456789abcdef0
Version: $Latest
TerminationPolicies:
- OldestInstance
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupNames

Lista

Opcional.

Nombres de los grupos a describir. Omítalo para devolver todos los grupos de la región.

["my-asg", "my-other-asg"]

maxRecords

En t

Opcional.

Número máximo de grupos a devolver. Máximo 100.

10

nextToken

Cadena

Opcional.

Token de paginación de una respuesta anterior.

"abcdefgh"

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "desiredCapacity", "expression": ".response.AutoScalingGroups[0].DesiredCapacity"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Descripción

response

Objeto

Contiene una matriz

AutoScalingGroups

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

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

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

name: asg-describe-group
workflowInputs:
arnRole:
type: String
steps:
- name: describeGroups
type: action
action: aws.autoscaling.describeAutoScalingGroups
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupNames:
- my-asg
selectors:
- name: desiredCapacity
expression: '.response.AutoScalingGroups[0].DesiredCapacity'
- name: minSize
expression: '.response.AutoScalingGroups[0].MinSize'
- name: maxSize
expression: '.response.AutoScalingGroups[0].MaxSize'
- name: instanceCount
expression: '.response.AutoScalingGroups[0].Instances | length'
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Requerido.

Nombre del grupo de Auto Scaling.

"my-asg"

instanceRefreshIds

Lista

Opcional.

ID de las actualizaciones específicas a describir. Omitir para obtener todas las actualizaciones del grupo.

["08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"]

maxRecords

En t

Opcional.

Número máximo de actualizaciones a devolver. Predeterminado 50, máx. 100.

10

nextToken

Cadena

Opcional.

Token de paginación de una respuesta anterior.

"abcdefgh"

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "status", "expression": ".response.InstanceRefreshes[0].Status"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Descripción

response

Objeto

Contiene una matriz

InstanceRefreshes

con

Status

,

PercentageComplete

y otros detalles de actualización. Consulte

describe_instance_refreshes — documentación de Boto3

para ver la sintaxis completa de la respuesta.

success

Booleano

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

en caso de éxito.

El siguiente ejemplo sondea el estado de una actualización iniciada en un paso anterior.

Ejemplo de flujo de trabajo

name: asg-poll-refresh
workflowInputs:
arnRole:
type: String
steps:
- name: describeRefresh
type: action
action: aws.autoscaling.describeInstanceRefreshes
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
instanceRefreshIds:
- ${{ .steps.startRefresh.outputs.instanceRefreshId }}
selectors:
- name: refreshStatus
expression: '.response.InstanceRefreshes[0].Status'
- name: percentComplete
expression: '.response.InstanceRefreshes[0].PercentageComplete'
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Opcional.

Nombre del grupo a consultar. Omitir para devolver las actividades de todos los grupos.

"my-asg"

activityIds

Lista

Opcional.

ID de actividades específicas a devolver.

["3b05db05-2f6e-4e86-af95-29f1f4c2a2b7"]

includeDeletedGroups

Booleano

Opcional.

Si es

true

, incluye actividades de grupos eliminados.

false

maxRecords

En t

Opcional.

Número máximo de actividades a devolver. Máximo 100.

10

nextToken

Cadena

Opcional.

Token de paginación de una respuesta anterior.

"abcdefgh"

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "latestStatus", "expression": ".response.Activities[0].StatusCode"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Descripción

response

Objeto

Contiene una matriz

Activities

con

ActivityId

,

StatusCode

,

Cause

y campos de tiempo. Consulte

describe_scaling_activities — Boto3 documentation

para obtener la sintaxis de respuesta completa.

success

Booleano

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

en caso de éxito.

El siguiente ejemplo recupera las 5 actividades de escalado más recientes.

Ejemplo de flujo de trabajo

name: asg-check-activities
workflowInputs:
arnRole:
type: String
steps:
- name: describeActivities
type: action
action: aws.autoscaling.describeScalingActivities
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
maxRecords: 5
selectors:
- name: latestActivity
expression: '.response.Activities[0].StatusCode'
next: end

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.

arn:aws:iam::123456789012:role/my-workflow-role

awsAccessKeyId

Cadena

Opcional.

ID de clave de acceso de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsAccessKeyId }}

awsSecretAccessKey

Cadena

Opcional.

Clave de acceso secreta de AWS. Debe pasarse como una referencia secreta.

${{ :secrets:awsSecretAccessKey }}

awsSessionToken

Cadena

Opcional.

Token de sesión de AWS para credenciales temporales. Debe pasarse como una referencia secreta.

${{ :secrets:awsSessionToken }}

región

Cadena

Requerido.

Región de AWS donde se encuentra el grupo de Auto Scaling.

"us-east-1"

autoScalingGroupName

Cadena

Opcional.

Nombre del grupo a consultar. Omítalo para listar las acciones en todos los grupos.

"my-asg"

scheduledActionNames

Lista

Opcional.

Nombres de las acciones específicas para devolver. Los nombres desconocidos se ignoran silenciosamente.

["scale-down-nights", "scale-up-mornings"]

startTime

Cadena

Opcional.

Límite inferior del timestamp UTC ISO 8601 para filtrar resultados.

"2024-01-01T00:00:00Z"

endTime

Cadena

Opcional.

Límite superior del timestamp UTC ISO 8601 para filtrar los resultados.

"2024-12-31T23:59:59Z"

maxRecords

En t

Opcional.

Número máximo de acciones a devolver. Máximo 100.

10

nextToken

Cadena

Opcional.

Token de paginación de una respuesta anterior.

"abcdefgh"

selectors

Lista

Opcional.

Selectores JQ para extraer campos específicos de la salida de la acción.

[{"name": "scheduledActions", "expression": ".response.ScheduledUpdateGroupActions"}]

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción

Tipo

Descripción

response

Objeto

Contiene una matriz

ScheduledUpdateGroupActions

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

true

si la acción se realizó correctamente,

false

de lo contrario.

errorMessage

Cadena

Mensaje de error si la acción falló.

null

en caso de éxito.

El siguiente ejemplo enumera todas las acciones programadas para un grupo.

Ejemplo de flujo de trabajo

name: asg-list-scheduled-actions
workflowInputs:
arnRole:
type: String
steps:
- name: describeScheduledActions
type: action
action: aws.autoscaling.describeScheduledActions
version: '1'
inputs:
awsRoleArn: ${{ .workflowInputs.arnRole }}
region: us-east-1
autoScalingGroupName: my-asg
selectors:
- name: scheduledActions
expression: '.response.ScheduledUpdateGroupActions'
next: end
Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.