• AWS Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

# 步骤 1：使用 AWS CLI 创建维护时段
<a name="mw-cli-tutorial-create-mw"></a>

在此步骤中，您将创建维护时段并指定其基本选项，如名称、计划和持续时间。在后面的步骤中，您选择它将更新的实例和运行的任务。

在我们的示例中，您将创建一个每 5 分钟运行的维护时段。通常您不会如此频繁地运行维护时段。不过，此速率可让您快速看到教程的结果。在任务成功运行之后，我们将向您展示如何改为较低频率的速率。

**注意**  
有关维护时段的各种计划相关选项如何相互关联的说明，请参阅 [维护时段计划和活动期间选项](maintenance-windows-schedule-options.md)。  
有关使用 `--schedule` 选项的更多信息，请参阅 [参考：适用于 Systems Manager 的 Cron 和 Rate 表达式](reference-cron-and-rate-expressions.md)。

**要使用 AWS CLI 创建维护时段**

1. 在您的本地计算机上打开 AWS Command Line Interface (AWS CLI) 并运行以下命令，创建执行以下任务的维护时段：
   + 每五分钟运行一次，持续时间最长两小时（根据需要）。
   + 在维护时段运行结束后的一小时内，阻止新任务启动。
   + 允许无关联的目标（您未注册到维护时段的实例）。
   + 通过使用自定义标签指示其创建方计划在本教程中使用它。

------
#### [ Linux & macOS ]

   ```
   aws ssm create-maintenance-window \
       --name "My-First-Maintenance-Window" \
       --schedule "rate(5 minutes)" \
       --duration 2 \
       --cutoff 1 \
       --allow-unassociated-targets \
       --tags "Key=Purpose,Value=Tutorial"
   ```

------
#### [ Windows ]

   ```
   aws ssm create-maintenance-window ^
       --name "My-First-Maintenance-Window" ^
       --schedule "rate(5 minutes)" ^
       --duration 2 ^
       --cutoff 1 ^
       --allow-unassociated-targets ^
       --tags "Key"="Purpose","Value"="Tutorial"
   ```

------

   系统返回类似于以下内容的信息。

   ```
   {
      "WindowId":"mw-0c50858d01EXAMPLE"
   }
   ```

1. 现在，运行以下命令来查看有关此维护时段以及您的账户中已有的任何其他维护时段的详细信息。

   ```
   aws ssm describe-maintenance-windows
   ```

   系统返回类似于以下内容的信息。

   ```
   {
      "WindowIdentities":[
         {
               "WindowId": "mw-0c50858d01EXAMPLE",
               "Name": "My-First-Maintenance-Window",
               "Enabled": true,
               "Duration": 2,
               "Cutoff": 1,
               "NextExecutionTime": "2019-05-11T16:46:16.991Z"
         }
      ]
   }
   ```

继续[步骤 2：使用 AWS CLI 将目标节点注册到维护时段](mw-cli-tutorial-targets.md)。