标记托管实例 - 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，然后选择标签选项卡。

    注意

    如果您希望看到的 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. 访问 https://console.aws.amazon.com/systems-manager/，打开 Amazon Systems Manager 控制台。

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

    -或者-

    如果Amazon Systems Manager首先打开主页，选择菜单图标（ ）以打开导航窗格中的，然后选择。Fleet 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"