标记 Systems Manager 参数

本节主题介绍如何在 AWS Systems Manager 参数上使用标签（SSM参数）。

创建带标签的参数

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

有关信息，请参阅以下主题：

• 创建 Systems Manager 参数（控制台）

• 创建 Systems Manager 参数 (AWS CLI)

• 创建 Systems Manager 参数 (Tools for Windows PowerShell)

向现有参数添加标签

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

主题

• 向现有参数添加标签（控制台）
• 向现有参数添加标签 (AWS CLI)
• 向现有参数添加标签 (AWS Tools for PowerShell)

向现有参数添加标签（控制台）

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

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

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

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

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

6. 选择保存。

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

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

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

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

向现有参数添加标签 (AWS 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 参数中删除标签（控制台）
• 从 SSM 参数中删除标签（命令行）

从 SSM 参数中删除标签（控制台）

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

2. 在导航窗格中，选择 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

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

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"