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

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

标记 Systems Manager 参数

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

创建带标签的参数

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

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

向现有参数添加标签

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

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

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

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

    -或者-

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

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

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

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

  6. 选择 Save

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

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

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

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

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

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

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

向现有参数添加标签 (适用于 PowerShell 的 AWS 工具)

  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"

从 Systems Manager 参数删除标签

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

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

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

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

    -或者-

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

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

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

  5. 选择 Save

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

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

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

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

  2. 运行以下命令以从参数中删除标签。

    Linux
    aws ssm remove-tags-from-resource \ --resource-type "Parameter" \ --resource-id "parameter-name" \ --tagkey "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
    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"