标记 Systems Manager 文档 - Amazon Systems Manager
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

标记 Systems Manager 文档

本节中的主题介绍如何在 Systems Manager 文档(SSM 文档)上使用标签。

创建带标签的文档

您可以在创建自定义 SSM 文档时向它们添加标签。

有关信息,请参阅以下主题:

向现有文档添加标签

您可以使用 Systems Manager 控制台或命令行向您拥有的自定义 SSM 文档添加标签。

向现有 SSM 文档添加标签(控制台)

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

  2. 在导航窗格中,选择 Documents

    -或者-

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

  3. 选择我拥有的选项卡。

  4. 选择要添加标签的文档的名称,然后选择详细信息选项卡。

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

  6. 选择 Save

向现有 SSM 文档添加标签(命令行)

向现有 SSM 文档添加标签(命令行)

  1. 通过使用首选命令行工具,运行以下命令来查看您可以标记的文档的列表。

    Linux & macOS
    aws ssm list-documents
    Windows
    aws ssm list-documents
    PowerShell
    Get-SSMDocumentList

    记下要标记的文档的名称。

  2. 运行以下命令以标记文档。

    Linux & macOS
    aws ssm add-tags-to-resource \ --resource-type "Document" \ --resource-id "document-name" \ --tags "Key=tag-key,Value=tag-value"
    Windows
    aws ssm add-tags-to-resource ^ --resource-type "Document" ^ --resource-id "document-name" ^ --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 "Document" ` -ResourceId "document-name" ` -Tag $tag ` -Force

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

    tag-value 是您要为该键提供的值的自定义内容。例如,WestQ321

    文档名称是要标记的 SSM 文档的名称。

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

  3. 运行以下命令验证文档标签。

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

从 SSM 文档中删除标签

您可以使用 Systems Manager 控制台或命令行从 SSM 文档中删除标签。

从 SSM 文档中删除标签(控制台)

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

  2. 在导航窗格中,选择 Documents

    -或者-

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

  3. 选择我拥有的选项卡。

  4. 选择要从中删除标签的文档的名称,然后选择详细信息选项卡。

  5. 标签部分中,选择编辑,然后选择不再需要的标签对旁边的删除

  6. 选择 Save

从 SSM 文档中删除标签(命令行)

  1. 通过使用首选命令行工具,运行以下命令列出您账户中的文档。

    Linux & macOS
    aws ssm list-documents
    Windows
    aws ssm list-documents
    PowerShell
    Get-SSMDocumentList

    记下要从中删除标签的文档的名称。

  2. 运行以下命令从文档中删除标签。

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

    文档名称是要从中删除标签的 SSM 文档的名称。

    tag-key 是指分配给文档的键的名称。例如,环境季度

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

  3. 运行以下命令验证文档标签。

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