Referencia: expresiones cron y rate para Systems Manager

Cuando crea una asociación de State Manager o un período de mantenimiento en AWS Systems Manager, debe especificar una programación de cuándo debe llevarse a cabo el período o la asociación. Puede especificar una programación como una entrada basada en el tiempo, lo que se conoce como expresión cron, o una entrada basada en la frecuencia, lo que se conoce como expresión rate.

Información general sobre las expresiones cron y rate

La siguiente información se aplica a las expresiones cron y rate para los periodos de mantenimiento y las asociaciones.

Expresiones cron y rate para asociaciones

En esta sección se incluyen ejemplos de expresiones cron y rate para asociaciones de State Manager. Para crear una de estas expresiones, tenga en cuenta la siguiente información:

Las asociaciones admiten expresiones cron que incluyen un día de la semana y el signo de número (#) para designar el día x de un mes para ejecutar una asociación. A continuación, se incluye un ejemplo en el que se ejecuta una programación cron el tercer martes de cada mes a las 23.30 h (UTC):

cron(30 23 ? * TUE#3 *)

A continuación, se incluye un ejemplo que se ejecuta el segundo jueves de cada mes a medianoche (UTC):

cron(0 0 ? * THU#2 *)

Las asociaciones también admiten el signo (L) para indicar el último día X del mes. A continuación, se incluye un ejemplo en el que se ejecuta una programación cron el último martes de cada mes a medianoche (UTC):

cron(0 0 ? * 3L *)

Para tener un mayor control sobre el momento en el que se ejecuta una asociación, por ejemplo, si desea ejecutar una asociación dos días después de la revisión del martes, puede especificar un desplazamiento. Un desplazamiento define los días que hay que esperar después del día programado para ejecutar una asociación. Por ejemplo, si especificó una programación cron de cron(0 0 ? * THU#2 *), puede especificar el número 3 en el campo Desplazamiento de programación para ejecutar la asociación cada domingo después del segundo jueves del mes.

Para utilizar los desplazamientos, debe elegir la opción Apply association only at the next specified Cron interval en la consola o debe especificar el uso del parámetro --apply-only-at-cron-interval desde la línea de comandos. Esta opción indica a State Manager que no ejecute ninguna asociación inmediatamente después de crearla.

En la siguiente tabla se presentan ejemplos de expresiones cron para asociaciones.

A continuación mostramos algunos ejemplos de rate para asociaciones.

Ejemplos de AWS CLI para asociaciones

Para crear asociaciones de un State Manager con el AWS CLI, incluya el parámetro --schedule-expression con una expresión cron o rate. En los ejemplos siguientes se utiliza la AWS CLI en un equipo Linux local.

aws ssm create-association \
    --association-name "My-Cron-Association" \
    --schedule-expression "cron(0 2 ? * SUN *)" \
    --targets Key=tag:ServerRole,Values=WebServer \
    --name AWS-UpdateSSMAgent

aws ssm create-association \
    --association-name "My-Rate-Association" \
    --schedule-expression "rate(7 days)" \
    --targets Key=tag:ServerRole,Values=WebServer \
    --name AWS-UpdateSSMAgent

aws ssm create-association \
    --association-name "My-Rate-Association" \
    --schedule-expression "at(2020-07-07T15:55:00)" \
    --targets Key=tag:ServerRole,Values=WebServer \
    --name AWS-UpdateSSMAgent \
    --apply-only-at-cron-interval

Expresiones cron y rate para los períodos de mantenimiento

En esta sección se incluyen ejemplos de expresiones cron y rate para períodos de mantenimiento.

A diferencia de las asociaciones de State Manager, los periodos de mantenimiento admiten todas las expresiones cron y rate. Esto incluye compatibilidad con los valores del campo de segundos.

Por ejemplo, la siguiente expresión cron de 6 campos ejecuta un periodo de mantenimiento a las 9:30 cada día.

cron(30 09 ? * * *)

Al agregar un valor al campo Seconds, la siguiente expresión cron de 7 campos ejecuta un periodo de mantenimiento a las 9:30:24 cada día.

cron(24 30 09 ? * * *)

En la siguiente tabla se proporcionan ejemplos de cron de 6 campos adicionales para períodos de mantenimiento.

En la siguiente tabla se proporcionan ejemplos rate para los períodos de mantenimiento.

Ejemplos de AWS CLI para períodos de mantenimiento

Para crear un periodo de mantenimiento con la AWS CLI, incluya el parámetro --schedule con una expresión cron o rate o una marca temporal. En los ejemplos siguientes se utiliza la AWS CLI en un equipo Linux local.

aws ssm create-maintenance-window \
    --name "My-Cron-Maintenance-Window" \
    --allow-unassociated-targets \
    --schedule "cron(0 16 ? * TUE *)" \
    --schedule-timezone "America/Los_Angeles" \
    --start-date 2021-01-01T00:00:00-08:00 \
    --end-date 2021-06-30T00:00:00-08:00 \
    --duration 4 \
    --cutoff 1

aws ssm create-maintenance-window \
    --name "My-Rate-Maintenance-Window" \
    --allow-unassociated-targets \
    --schedule "rate(7 days)" \
    --duration 4 \
    --schedule-timezone "America/Los_Angeles" \
    --cutoff 1

aws ssm create-maintenance-window \
    --name "My-TimeStamp-Maintenance-Window" \
    --allow-unassociated-targets \
    --schedule "at(2021-07-07T13:15:30)" \
    --duration 4 \
    --schedule-timezone "America/Los_Angeles" \
    --cutoff 1