标记维护时段 - Amazon Systems Manager
创建带有标签的维护时段将标签添加到现有维护时段从维护时段中删除标签
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

标记维护时段

本节主题介绍如何在维护时段上使用标签。

创建带有标签的维护时段

您可以在创建维护时段时向维护时段添加标签。

有关信息，请参阅以下主题：

将标签添加到现有维护时段

您可以使用 Amazon Systems Manager 控制台或命令行将标签添加到您拥有的维护时段。

将标签添加到现有维护时段（控制台）

  1. 访问 https://console.aws.amazon.com/systems-manager/，打开 Amazon Systems Manager 控制台。

  2. 在导航窗格中，选择 Maintenance Windows。

    -或者-

    如果首先打开 Amazon Systems Manager 主页，选择菜单图标 ( The menu icon ) 打开导航窗格，然后选择 Maintenance Windows。

  3. 选择您创建的维护时段的名称，然后选择 Tags (标签) 选项卡。

  4. 选择 Edit tags (编辑标签)，然后选择 Add tag (添加标签)。

  5. 对于 Key (键)，输入标签的键，如 Environment。

  6. 对于 Value (值)，输入标签的值，如 Test。

  7. 选择 Save changes（保存更改）。

将标签添加到现有维护时段 (Amazon CLI)

  1. 通过使用首选命令行工具，运行以下命令来查看您可以标记的维护时段的列表。

    aws ssm describe-maintenance-windows

    记下要标记的维护时段的 ID。

  2. 运行以下命令来标记维护时段。将每个示例资源占位符替换为您自己的信息。

    Linux & macOS
    aws ssm add-tags-to-resource \
    --resource-type "MaintenanceWindow" \
    --resource-id "window-id" \
    --tags "Key=tag-key,Value=tag-value"
    Windows
    aws ssm add-tags-to-resource ^
    --resource-type "MaintenanceWindow" ^
    --resource-id "window-id" ^
    --tags "Key=tag-key,Value=tag-value"

    如果成功，则命令没有输出。

  3. 运行以下命令以验证维护时段标签。

    Linux & macOS
    aws ssm list-tags-for-resource \
    --resource-type "MaintenanceWindow" \
    --resource-id "window-id"
    Windows
    aws ssm list-tags-for-resource ^
    --resource-type "MaintenanceWindow" ^
    --resource-id "window-id"

标记维护时段 (Amazon Tools for PowerShell)

  1. 运行以下命令列出可标记的维护时段。

    Get-SSMMaintenanceWindow

  2. 运行以下命令来标记维护时段。

    $tag = New-Object Amazon.SimpleSystemsManagement.Model.Tag
    $tag.Key = "tag-key"
    $tag.Value = "tag-value"
    Add-SSMResourceTag `
    -ResourceType "MaintenanceWindow" `
    -ResourceId "window-id" `
    -Tag $tag

    window-id 要标记的维护时段的 ID。

    tag-key 是您提供的自定义键的名称。例如，环境 或项目。

    tag-value 是您要为该键提供的值的自定义内容。例如，生产 或 Q321。

  3. 运行以下命令以验证维护时段标签。

    Get-SSMResourceTag `
    -ResourceType "MaintenanceWindow" `
    -ResourceId "window-id"

从维护时段中删除标签

您可以使用 Systems Manager 控制台或命令行从维护时段中删除标签。

从维护时段中删除标签（控制台）

  1. 访问 https://console.aws.amazon.com/systems-manager/，打开 Amazon Systems Manager 控制台。

  2. 在导航窗格中，选择 Maintenance Windows。

    -或者-

    如果首先打开 Amazon Systems Manager 主页，选择菜单图标 ( The menu icon ) 打开导航窗格，然后选择 Maintenance Windows。

  3. 选择要从中删除标签的维护时段的名称，然后选择 Tags (标签) 选项卡。

  4. 选择 Edit tags (编辑标签)，然后选择不再需要的标签对旁边的 Remove tag (删除标签)。

  5. 选择 Save changes（保存更改）。

从维护时段中删除标签（命令行）

  1. 使用首选命令行工具，运行以下命令以列出您账户中的维护时段。

    Linux & macOS
    aws ssm describe-maintenance-windows
    Windows
    aws ssm describe-maintenance-windows
    PowerShell
    Get-SSMMaintenanceWindows

    记下要从中删除标签的维护时段的 ID。

  2. 运行以下命令，从维护时段中删除标签。将每个示例资源占位符替换为您自己的信息。

    Linux & macOS
    aws ssm remove-tags-from-resource \
    --resource-type "MaintenanceWindow" \
    --resource-id "window-id" \
    --tag-key "tag-key"
    Windows
    aws ssm remove-tags-from-resource ^
    --resource-type "MaintenanceWindow" ^
    --resource-id "window-id" ^
    --tag-key "tag-key"
    PowerShell
    Remove-SSMResourceTag `
    -ResourceType "MaintenanceWindow" `
    -ResourceId "window-id" `
    -TagKey "tag-key

    如果成功，则命令没有输出。

  3. 运行以下命令以验证维护时段标签。

    Linux & macOS
    aws ssm list-tags-for-resource \
    --resource-type "MaintenanceWindow" \
    --resource-id "window-id"
    Windows
    aws ssm list-tags-for-resource ^
    --resource-type "MaintenanceWindow" ^
    --resource-id "window-id"
    PowerShell
    Get-SSMResourceTag `
    -ResourceType "MaintenanceWindow" `
    -ResourceId "window-id"