Systems Manager パラメータにタグをつける - AWS Systems Manager

Systems Manager パラメータにタグをつける

このセクションのトピックでは、AWS Systems Manager パラメータ (SSM パラメータ) のタグの機能について説明します。

タグを使用したパラメータの作成

SSM パラメータを作成するときに、タグを追加できます。

詳細については、以下のトピックを参照してください。

既存のパラメータへのタグの追加

Systems Manager コンソールまたはコマンドラインを使用して、所有しているカスタム SSM パラメータにタグを追加できます。

既存のパラメータにタグを追加する (コンソール)

  1. AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/) を開きます。

  2. ナビゲーションペインで、[Parameter Store] を選択します。

    -または-

    AWS Systems Manager ホームページを最初に開く場合は、メニューアイコン ( 
    The menu icon
  ) を選択してナビゲーションペインを開き、[Parameter Store] を選択します。

  3. 作成済みのパラメータの名前を選択し、[Tags] タブを選択します。

  4. 最初のボックスに、タグのキーとして Environment などを入力します。

  5. 2 番目のボックスに、タグの値として 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"

    成功した場合は、コマンドの出力はありません。

  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"

パラメータからタグを削除する

Systems Manager コンソールまたはコマンドラインを使用して、SSM パラメータからタグを削除できます。

SSM パラメータからタグを削除する (コンソール)

  1. AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/) を開きます。

  2. ナビゲーションペインで、[Parameter Store] を選択します。

    -または-

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