AWS Systems Manager
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

步骤 3:向维护时段注册任务 (AWS CLI)

在本教程的此步骤中,您将注册 Run Command 任务,在 Amazon EC2 实例 (Linux) 上运行 df 命令。此标准 Linux 命令的结果显示实例的磁盘文件系统上的空闲空间数量和已用空间数量。

-或者-

如果您针对 Windows Server 实例上而不是 Linux 上的 Amazon EC2 实例,请将以下命令中的 df 替换为 ipconfig。此命令的输出列出了有关目标实例上适配器的 IP 地址、子网掩码和默认网关等详细信息。

当您准备好注册其他任务类型,或使用多个可用 Run Command 选项的更多信息时,请参阅示例:向维护时段注册任务。我们在这里提供了有关全部四种任务类型的更多信息,以及它们最重要的一些选项,以帮助您针对更广泛的真实场景制定计划。

向维护时段注册任务

  1. 根据本地计算机上的操作系统类型,运行以下命令之一。从本地 Windows 计算机运行的版本包含转义字符 (“/”),您需要从命令行工具运行命令。

    Windows 本地计算机:

    aws ssm register-task-with-maintenance-window --window-id mw-0c50858d01EXAMPLE --task-arn "AWS-RunShellScript" --max-concurrency 1 --max-errors 1 --priority 10 --targets "Key=InstanceIds,Values=i-02573cafcfEXAMPLE" --task-type "RUN_COMMAND" --task-invocation-parameters={\"RunCommand\":{\"Parameters\":{\"commands\":[\"df\"]}}}

    Linux 本地计算机:

    aws ssm register-task-with-maintenance-window --window-id mw-0c50858d01EXAMPLE --task-arn "AWS-RunShellScript" --max-concurrency 1 --max-errors 1 --priority 10 --targets "Key=InstanceIds,Values=i-0471e04240EXAMPLE" --task-type "RUN_COMMAND" --task-invocation-parameters '{"RunCommand":{"Parameters":{"commands":["df"]}}}'

    系统返回类似于下文的信息:

    {
        "WindowTaskId": "4f7ca192-7e9a-40fe-9192-5cb15EXAMPLE"
    }
  2. 现在,运行以下命令查看有关您创建的维护时段任务的详细信息。

    aws ssm describe-maintenance-window-tasks --window-id mw-0c50858d01EXAMPLE
  3. 系统返回类似于下文的信息:

    {
        "Tasks": [
            {
                "WindowId": "mw-0c50858d01EXAMPLE",
                "WindowTaskId": "4f7ca192-7e9a-40fe-9192-5cb15EXAMPLE",
                "TaskArn": "AWS-RunShellScript",
                "Type": "RUN_COMMAND",
                "Targets": [
                    {
                        "Key": "InstanceIds",
                        "Values": [
                            "i-02573cafcfEXAMPLE"
                        ]
                    }
                ],
                "TaskParameters": {},
                "Priority": 10,
                "ServiceRoleArn": "arn:aws:iam::123456789012:role/aws-service-role/ssm.amazonaws.com/AWSServiceRoleForAmazonSSM",
                "MaxConcurrency": "1",
                "MaxErrors": "1"
            }
        ]
    }
  4. 请耐心等待,直到有足够的时间根据您在步骤 1:创建维护时段 (AWS CLI) 中指定的计划运行任务。例如,如果您指定 --schedule "rate(5 minutes)",则等待五分钟。然后,运行以下命令来查看此任务所进行的任何执行的相关信息。

    aws ssm describe-maintenance-window-executions --window-id mw-0c50858d01EXAMPLE

    系统返回类似于下文的信息:

    {
        "WindowExecutions": [
            {
                "WindowId": "mw-0c50858d01EXAMPLE",
                "WindowExecutionId": "14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE",
                "Status": "SUCCESS",
                "StartTime": 1557593493.096,
                "EndTime": 1557593498.611
            }
        ]
    }

提示

任务成功完成后,您可以减少运行维护时段的频率。例如,运行以下命令以将频率减少为每周一次:

aws ssm update-maintenance-window --window-id mw-0c50858d01EXAMPLE --schedule "rate(7 days)"

有关管理维护时段计划的更多信息,请参阅参考:Systems Manager 的 Cron 和 Rate 表达式参考:维护时段计划和活动期间选项

有关使用 AWS CLI 来修改维护时段的信息,请参阅教程:更新维护时段 (AWS CLI)

有关运行 AWS CLI 命令以查看有关维护时段任务及其执行详细信息的练习,请转到教程:查看有关任务和任务执行的信息 (AWS CLI)

关于教程命令输出

使用 AWS CLI 查看与维护时段任务执行相关联 Run Command 命令的输出 超过了本教程的范围。

不过,您可以使用 AWS CLI 查看此数据。(您还可以在 Systems Manager 控制台中或存储在 Amazon S3 存储桶的日志文件中(如果您已配置维护时段在其中存储命令输出)查看输出。) 您会看到,Linux 实例上 df 命令的输出类似于下文:

Filesystem 1K-blocks Used Available Use% Mounted on

devtmpfs 485716 0 485716 0% /dev

tmpfs 503624 0 503624 0% /dev/shm

tmpfs 503624 328 503296 1% /run

tmpfs 503624 0 503624 0% /sys/fs/cgroup

/dev/xvda1 8376300 1464160 6912140 18% /

Windows Server 实例上 ipconfig 命令的输出类似于下文:

Windows IP Configuration


Ethernet adapter Ethernet 2:

   Connection-specific DNS Suffix  . : example.com
   IPv4 Address. . . . . . . . . . . : 10.24.34.0/23
   Subnet Mask . . . . . . . . . . . : 255.255.255.255
   Default Gateway . . . . . . . . . : 0.0.0.0

Ethernet adapter Ethernet:

   Media State . . . . . . . . . . . : Media disconnected
   Connection-specific DNS Suffix  . : abc1.wa.example.net

Wireless LAN adapter Local Area Connection* 1:

   Media State . . . . . . . . . . . : Media disconnected
   Connection-specific DNS Suffix  . :

Wireless LAN adapter Wi-Fi:

   Connection-specific DNS Suffix  . :
   Link-local IPv6 Address . . . . . : fe80::100b:c234:66d6:d24f%4
   IPv4 Address. . . . . . . . . . . : 192.0.2.0
   Subnet Mask . . . . . . . . . . . : 255.255.255.0
   Default Gateway . . . . . . . . . : 192.0.2.0

Ethernet adapter Bluetooth Network Connection:

   Media State . . . . . . . . . . . : Media disconnected
   Connection-specific DNS Suffix  . :