标记托管式节点 - Amazon Systems Manager
创建或激活带标签的托管式节点向现有托管式节点添加标签删除托管式节点中的标签
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

标记托管式节点

本节主题介绍如何在托管式节点上使用标签。

托管式节点是为 Amazon Systems Manager 配置的任何计算机，包括 Amazon Elastic Compute Cloud (Amazon EC2) 实例、边缘设备以及混合环境中为 Systems Manager 配置的本地服务器或虚拟机 (VM)。

本主题中的说明适用于使用 Systems Manager 管理的任何计算机。

创建或激活带标签的托管式节点

您可以在创建 EC2 实例时向它们添加标签。您可以在激活本地服务器和虚拟机 (VM) 时向它们添加标签。

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

向现有托管式节点添加标签

您可以使用 Systems Manager 控制台或命令行向托管式节点添加标签。

向现有托管式节点添加标签（控制台）

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

  2. 在导航窗格中，选择 Fleet Manager。

    -或者-

    如果首先打开 Amazon Systems Manager 主页，选择菜单图标 ( ) 以打开导航窗格，然后在导航窗格中选择 Fleet Manager。

  3. 选择要向其添加标签的托管式节点的 ID，然后选择 Tags（标签）选项卡。

    注意

    如果未列出您希望看到的托管式节点，请参阅 排除托管式节点可用性的问题 以获取故障排除技巧。

  4. 在标签部分中，选择编辑，然后添加一个或多个键值标签对。

  5. 选择保存。

向现有托管式节点添加标签（命令行）

要向现有托管式节点添加标签（命令行），请执行以下步骤

  1. 使用首选命令行工具，运行以下命令以查看可标记的托管式节点的列表。

    Linux & macOS
    aws ssm describe-instance-information
    Windows
    aws ssm describe-instance-information
    PowerShell
    Get-SSMInstanceInformation

    记下要标记的托管式节点的 ID。

    注意

    已注册为在混合环境中与 Systems Manager 一起使用的计算机以 mi- 开头，例如 mi-0471e04240EXAMPLE。EC2 实例具有以 i- 开头的 ID，例如 i-02573cafcfEXAMPLE。

  2. 运行以下命令来标记托管式节点。

    Linux & macOS
    aws ssm add-tags-to-resource \
    --resource-type "ManagedInstance" \
    --resource-id "instance-id" \
    --tags "Key=tag-key,Value=tag-value"
    Windows
    aws ssm add-tags-to-resource ^
    --resource-type "ManagedInstance" ^
    --resource-id "instance-id" ^
    --tags "Key=tag-key,Value=tag-value"
    PowerShell
    $tag = New-Object Amazon.SimpleSystemsManagement.Model.Tag
    $tag.Key = "tag-key"
    $tag.Value = "tag-value"
    Add-SSMResourceTag `
    -ResourceType "ManagedInstance" `
    -ResourceId "instance-id" `
    -Tag $tag `
    -Force

    tag-key 是您提供的自定义键的名称。例如，区域或季度。

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

    instance-id 是要标记的托管式节点的 ID。

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

  3. 运行以下命令以验证托管式节点的标签。

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

删除托管式节点中的标签

您可以使用 Systems Manager 控制台或命令行删除托管式节点中的标签。

删除托管式节点中的标签（控制台）

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

  2. 在导航窗格中，选择 Fleet Manager。

    -或者-

    如果首先打开 Amazon Systems Manager 主页，选择菜单图标 ( ) 以打开导航窗格，然后在导航窗格中选择 Fleet Manager。

  3. 选择要删除其中标签的托管式节点的名称，然后选择 Tags（标签）选项卡。

  4. 在标签部分中，选择编辑，然后选择不再需要的标签对旁边的删除。

  5. 选择保存。

删除托管式节点中的标签（命令行）

  1. 使用首选命令行工具，运行以下命令以列出您账户中的托管式节点。

    Linux & macOS
    aws ssm describe-instance-information
    Windows
    aws ssm describe-instance-information
    PowerShell
    Get-SSMInstanceInformation

    记下要删除其中标签的托管式节点的名称。

  2. 运行以下命令以删除托管式节点中的标签。

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

    instance-id 是要删除其中标签的托管式节点的名称。

    tag-key 是分配给该托管式节点的键的名称。例如，环境 或季度。

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

  3. 运行以下命令以验证托管式节点的标签。

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