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

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

标记托管实例

本节中的主题介绍如何在托管实例上使用标签。

托管实例是为 AWS Systems Manager 配置的任何计算机。这包括 Amazon Elastic Compute Cloud (Amazon EC2) 实例，以及您已配置为在混合环境中使用 Systems Manager 进行管理的本地服务器或虚拟机 (VM)。

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

创建或激活带标签的托管实例

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

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

向现有托管实例添加标签

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

向现有托管实例添加标签（控制台）

  1. 以下网址打开 AWS Systems Manager 控制台：https://console.aws.amazon.com/systems-manager/。

  2. 在导航窗格中，选择队列管理管理。

    -或者-

    如果首先打开 AWS Systems Manager 主页，请选择菜单图标 ( ）以打开导航窗格中的，然后选择队列管理管理导航窗格中的。

  3. 选择要向其添加标签的托管实例的名称，然后选择 Tags (标签) 选项卡。

    注意

    如果未列出您希望看到的 Amazon EC2 实例，请参阅Amazon EC2 托管实例可用性疑难解答以获取故障排除提示。

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

  5. 选择 Save。

向现有托管实例添加标签（命令行）

向现有托管实例添加标签（命令行）

  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. 以下网址打开 AWS Systems Manager 控制台：https://console.aws.amazon.com/systems-manager/。

  2. 在导航窗格中，选择队列管理管理。

    -或者-

    如果首先打开 AWS Systems Manager 主页，请选择菜单图标 ( ）以打开导航窗格中的，然后选择队列管理管理导航窗格中的。

  3. 选择要从中删除标签的托管实例的名称，然后选择 Tags (标签) 选项卡。

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

  5. 选择 Save。

从托管实例中删除标签（命令行）

  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"