Amazon Managed Grafana ワークスペースにタグを付ける

Amazon Managed Grafana ワークスペースのタグを操作するには、このセクションの手順を使用します。

ワークスペースへのタグの追加

Amazon Managed Grafana ワークスペースにタグ (キーと値のペア) を追加すると、 AWS リソースの特定と整理に役立ちます。まず、ワークスペースに 1 つ以上のタグを追加してから、これらのタグに基づいてワークスペースへのアクセスを管理する IAM ポリシーを作成できます。コンソールまたは AWS CLI を使用して、Amazon Managed Grafana ワークスペースにタグを追加できます。

重要

ワークスペースにタグを追加すると、そのワークスペースへのアクセスに影響が生じる可能性があります。ワークスペースにタグを追加する前に、タグを使用してリソースへのアクセスを制御している可能性のある IAM ポリシーをすべて確認してください。

作成時に Amazon Managed Grafana ワークスペースにタグを追加する方法の詳細については、Amazon Managed Grafana ワークスペースを作成する「Amazon Managed Grafana ユーザーガイド」の「」を参照してください。

Console

コンソールを使用して、Amazon Managed Grafana ワークスペースに 1 つ以上のタグを追加できます。

1. https://console.aws.amazon.com/grafana/ で Amazon Managed Grafana コンソールを開きます。

2. 左側のナビゲーションペインで、メニューアイコンを選択します。

3. すべてのワークスペース を選択します。

4. 管理するワークスペースのワークスペース ID を選択します。

5. [タグ] タブを選択します。

6. [タグを管理] を選択します。

7. キー フィールドに、タグの名前を入力します。値 フィールドにタグのオプションの値を追加できます。

8. （オプション) 別のタグを追加するには、タグの追加 を選択します。

9. タグの追加が完了したら、[変更を保存] を選択します。

CLI

AWS CLI を使用して Amazon Managed Grafana ワークスペースに 1 つ以上のタグを追加するには、次の手順に従います。

• ターミナルまたはコマンドラインで、 tag-resource コマンドを実行し、タグを追加するワークスペースの Amazon リソースネーム (ARN) と、追加するタグのキーと値を指定します。ワークスペースには複数のタグを追加できます。例えば、Grafana ワークスペースの My-Workspace に Name という名前のタグキーに my_key_value のタグ値でタグ付けするには、次のコマンドを実行します。

  aws grafana tag-resource --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/My-Workspace --tags "Name=my_key_value"

ワークスペースのタグの表示

Amazon Managed Grafana ワークスペースに関連付けられたタグを表示できます。タグ付け戦略の詳細については、「 AWS 全般のリファレンス」の「 AWS リソースのタグ付け」を参照してください。

Console

コンソールを使用して、Amazon Managed Grafana ワークスペースに関連付けられているタグを表示できます。

1. https://console.aws.amazon.com/grafana/ で Amazon Managed Grafana コンソールを開きます。

2. 左側のナビゲーションペインで、メニューアイコンを選択します。

3. [すべての WorkSpaces] を選択します。

4. 管理するワークスペースのワークスペース ID を選択します。

5. [タグ] タブを選択します。

CLI

AWS CLI を使用して Amazon Managed Grafana ワークスペースの AWS タグを表示するには、次の手順に従います。タグが追加されていない場合、返されるリストは空になります。

ターミナルまたはコマンドラインで、 list-tags-for-resource コマンドを実行します。例えば、ワークスペースのタグキーとタグ値のリストを表示するには、次のコマンドを実行します。

aws grafana list-tags-for-resource --resoure-arn arn:aws:grafana:us-west-2:/workspace/workspace-IDstring

成功した場合、このコマンドは次のような情報を返します。

{
    "tags": {
        "Status": "Secret",
        "Team": "My-Team"
    }
}

ワークスペースのタグの編集

TagResource API を使用して、ワークスペースに関連付けられたタグの値を 1 回の呼び出しで変更できます。既存のタグのキーを更新するには、 UntagResourceと TagResource APIsを組み合わせる必要があります。

重要

Amazon Managed Grafana ワークスペースのタグを編集すると、そのワークスペースへのアクセスに影響を与える可能性があります。ワークスペースのタグを編集する前に、タグのキーまたは値を使用してリポジトリなどのリソースへのアクセスを制御する可能性のある IAM ポリシーを必ず確認してください。

Console

コンソールを使用して、Amazon Managed Grafana ワークスペースに関連付けられたタグを編集できます。

1. Grafana コンソール で Amazon Managed Grafana コンソールを開きます。

2. 左側のナビゲーションペインで、メニューアイコンを選択します。

3. [すべての WorkSpaces] を選択します。

4. 管理するワークスペースのワークスペース ID を選択します。

5. [タグ] タブを選択します。

6. [タグを管理] を選択します。

7. キー フィールドに、タグの名前を入力します。値フィールドにタグのオプションの値を追加できます。

8. タグの編集が完了したら、変更を保存 を選択します。

CLI

を使用してワークスペースのタグ AWS CLI を更新するには、次の手順に従います。既存のキーの値を変更するか、別のキーを追加できます。

ターミナルまたはコマンドラインで、tag-resource コマンドを実行し、タグを更新してタグキーとタグ値を指定する Amazon Managed Grafana ワークスペースの Amazon リソースネーム (ARN) を指定します。

例えば、タグの値を新しい値 Key_value_new で変更するには、次のコマンドを実行します。

aws grafana tag-resource \
    --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/workspace-IDstring \
    --tags "Name=Key_value_new"

新しい名前 Name_new でタグのキーを変更するには、次のコマンドを実行します。

aws grafana untag-resource --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/workspace-IDstring --tag-keys Items=Name
aws grafana tag-resource --resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/workspace-IDstring --tags "Name_new=Key_value_old"

ワークスペースからのタグの削除

ワークスペースに関連付けられている 1 つ以上のタグを削除できます。タグを削除しても、そのタグに関連付けられている他の AWS リソースからタグは削除されません。

重要

Amazon Managed Grafana ワークスペースからタグを削除すると、そのワークスペースへのアクセスに影響する可能性があります。ワークスペースからタグを削除する前に、タグのキーまたは値を使用してワークスペースなどのリソースへのアクセスを制御する可能性のある IAM ポリシーを必ず確認してください。

Console

コンソールを使用して、タグとワークスペースとの関連付けを解除できます。

1. Grafana コンソール で Amazon Managed Grafana コンソールを開きます。

2. 左側のナビゲーションペインで、メニューアイコンを選択します。

3. [すべての WorkSpaces] を選択します。

4. 管理するワークスペースのワークスペース ID を選択します。

5. [タグ] タブを選択します。

6. [タグを管理] を選択します。

7. 削除するタグを見つけて、 の削除を選択します。

8. タグの削除が完了したら、変更を保存 を選択します。

CLI

を使用してワークスペースからタグ AWS CLI を削除するには、次の手順に従います。タグを削除しても、他のリソースからタグは削除されませんが、タグとワークスペース間の関連付けは削除されます。

注記

Amazon Managed Grafana ワークスペースを削除すると、削除されたワークスペースからすべてのタグの関連付けが削除されます。ワークスペースを削除する前にタグを削除する必要はありません。

ターミナルまたはコマンドラインで、untag-resource コマンドを実行し、タグを削除するワークスペースの Amazon リソースネーム (ARN) と、削除するタグのタグキーを指定します。例えば、space-IDstring という名前のワークスペースでタグキー を持つタグを削除するには、次のコマンドを実行します。

aws grafana untag-resource --resoure-arn arn:aws:grafana:us-west-2:/workspaces/workspace-IDstring --tag-keys Items=Name

成功すると、このコマンドは空のレスポンスを返します。ワークスペースに関連付けられたタグが削除されたことを確認するには、 list-tags-for-resource コマンドを実行します。