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

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

标记 Systems Manager 参数

本节主题介绍如何在 Amazon Systems Manager 参数上使用标签(SSM参数)。

创建带标签的参数

您可以在创建 SSM 参数时向它们添加标签。

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

向现有参数添加标签

您可以使用 Systems Manager 控制台或命令行,将标签添加到您拥有的自定义 SSM 参数中。

向现有参数添加标签(控制台)

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

  2. 在导航窗格中,选择 Parameter Store

    -或者-

    如果首先打开 Amazon Systems Manager 主页,选择菜单图标( 
    The menu icon
  )打开导航窗格,然后选择 Parameter Store

  3. 选择您创建的参数的名称,然后选择 Tags 选项卡。

  4. 在第一个框中,为标签输入键,如 Environment

  5. 在第二个框中,为标签输入值,如 Test

  6. 选择 Save(保存)。

向现有参数添加标签 (Amazon CLI)

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

    aws ssm describe-parameters

    记下要标记的参数的名称。

  2. 运行以下命令标记一个参数。将每个示例资源占位符替换为您自己的信息。

    aws ssm add-tags-to-resource \ --resource-type "Parameter" \ --resource-id "parameter-name" \ --tags "Key=tag-key,Value=tag-value"

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

  3. 运行以下命令验证参数标签。

    aws ssm list-tags-for-resource --resource-type "Parameter" --resource-id "parameter-name"

向现有参数添加标签 (Amazon Tools for PowerShell)

  1. 运行以下命令列出您可以标记的参数。

    Get-SSMParameterList
  2. 运行以下命令标记一个参数。将每个示例资源占位符替换为您自己的信息。

    $tag = New-Object Amazon.SimpleSystemsManagement.Model.Tag
    $tag.Key = "tag-key"
    $tag.Value = "tag-value"
    Add-SSMResourceTag ` -ResourceType "Parameter" ` -ResourceId "parameter-name" ` -Tag $tag ` -Force
  3. 运行以下命令验证参数标签。

    Get-SSMResourceTag ` -ResourceType "Parameter" ` -ResourceId "parameter-name"

从 SSM 参数中删除标签

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

从 SSM 参数中删除标签(控制台)

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

  2. 在导航窗格中,选择 Parameter Store

    -或者-

    如果首先打开 Amazon Systems Manager 主页,选择菜单图标( 
    The menu icon
  )打开导航窗格,然后选择 Parameter Store

  3. 选择要从中删除标签的参数的名称,然后选择 Tags (标签) 选项卡。

  4. 选择不再需要的标签对旁边的 Remove (删除)

  5. 选择 Save(保存)。

从 SSM 参数中删除标签(命令行)

  1. 使用您的首选命令行工具,运行以下命令以列出您的账户中的参数。

    Linux & macOS
    aws ssm describe-parameters
    Windows
    aws ssm describe-parameters
    PowerShell
    Get-SSMParameterList

    记下要从中删除标签的参数的名称。

  2. 运行以下命令以从参数中删除标签。将每个示例资源占位符替换为您自己的信息。

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

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

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

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