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

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

标记 Systems Manager 文档

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

创建带标签的文档

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

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

向现有文档添加标签

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

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

  1. 通过以下网址打开 AWS Systems Manager 控制台:https://console.amazonaws.cn/systems-manager/

  2. 在导航窗格中,选择文档

    -或者-

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

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

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

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

  6. 选择 Save

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

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

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

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

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

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

    Linux
    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

    document-name 是您要标记的 SSM 文档的名称。

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

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

    Linux
    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"

从 Systems Manager 文档中删除标签

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

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

  1. 通过以下网址打开 AWS Systems Manager 控制台:https://console.amazonaws.cn/systems-manager/

  2. 在导航窗格中,选择文档

    -或者-

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

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

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

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

  6. 选择 Save

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

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

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

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

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

    Linux
    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

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

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

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

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

    Linux
    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"