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

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

标记 Systems Manager 参数

本节中的主题介绍如何在Amazon Web Services Systems Manager参数(SSM 参数)。

创建带标签的参数

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

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

向现有参数添加标签

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

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

  1. 打开Amazon Web Services Systems Manager控制台位于https://console.aws.amazon.com/systems-manager/

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

    -或者-

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

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

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

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

  6. 选择保存

向现有参数添加标签 (AmazonCLI)

  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"

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

    parameter-name是要标记的 SSM 参数的名称。

    tag-key 是您提供的自定义键的名称。例如,环境项目

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

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

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

向现有参数添加标签 (AmazonTools 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

    parameter-name要标记的 SSM 参数的名称。

    tag-key 是您提供的自定义键的名称。例如,环境项目

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

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

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

从 SSM 参数删除标签

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

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

  1. 打开Amazon Web Services Systems Manager控制台位于https://console.aws.amazon.com/systems-manager/

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

    -或者-

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

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

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

  5. 选择保存

从 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

    parameter-name是要从中删除标签的 SSM 参数的名称。

    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"