参考：适用于 Systems Manager 的 Cron 和 Rate 表达式

在 AWS Systems Manager 中创建 State Manager 关联或维护时段时，您需要指定一个说明该时段或关联应在何时运行的计划。您能够以基于时间的条目（称为 cron 表达式）或基于频率的条目（称为 rate 表达式）的形式指定计划。

有关 Cron 和 Rate 表达式的一般信息

以下信息适用于维护时段和关联的 cron 和 rate 表达式。

适用于关联的 Cron 和 Rate 表达式

此部分包括适用于 State Manager 关联的 cron 和 rate 表达式的示例。在您创建这些表达式之前，请注意以下信息：

关联支持 cron 表达式，其中包括一周中的某一天，数字符号 (#) 用于指定一个月的第 n 天来运行关联。以下是一个在每月的第三个星期二 23:30 UTC 运行 cron 计划的示例：

cron(30 23 ? * TUE#3 *)

以下是一个在每月的第二个星期四在 UTC 午夜运行的示例：

cron(0 0 ? * THU#2 *)

关联还支持 (L) 符号来表示一个月的最后一个 X 天。以下是一个在每月的最后一个星期二 UTC 午夜运行 cron 计划的示例：

cron(0 0 ? * 3L *)

要进一步控制关联运行的时间，例如，如果您想在星期二补丁后两天运行关联，可以指定偏移量。偏移量定义了在计划日期之后等待多少天再运行关联。例如，如果指定的 cron 计划为 cron(0 0 ? * THU#2 *)，则可以在 Schedule offset（计划偏移量）字段中指定数字 3，以便在每月的第二个星期四之后的每个星期天运行关联。

要使用偏移量，必须在控制台中选择 Apply association only at the next specified Cron interval（仅在下一个指定的 Cron 周期应用关联）选项，或者必须从命令行指定使用 --apply-only-at-cron-interval 参数。此选项将告知 State Manager 不要在创建关联后立即运行关联。

下表提供了适用于关联的 cron 示例。

以下是一些适用于关联的 rate 示例。

适用于关联的 AWS CLI 示例

要使用 AWS CLI 创建State Manager关联，您可以使用 cron 或 rate 表达式包含 --schedule-expression 参数。以下是在本地 Linux 计算机上使用 AWS CLI 的示例。

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

适用于维护时段的 Cron 和 Rate 表达式

本节包括适用于维护时段的 cron 和 rate 表达式的示例。

与 State Manager 关联不同，维护时段支持所有 cron 和 rate 表达式。这包括支持秒数字段中的值。

例如，下面的 6 字段 cron 表达式在每天上午 9:30 运行维护时段。

cron(30 09 ? * * *)

通过向 Seconds 字段添加一个值，下面的 7 字段 cron 表达式在每天上午 9:30:24 运行维护时段。

cron(24 30 09 ? * * *)

下表提供更多适用于维护时段的 6 字段 cron 示例。

下表提供维护时段的 rate 示例。

适用于维护时段的 AWS CLI 示例

要使用 AWS CLI 创建维护时段，您可以使用 cron 或 rate 表达式或者时间戳包含 --schedule 参数。以下是在本地 Linux 计算机上使用 AWS CLI 的示例。

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