翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Managed Grafana ワークスペースのタグを付け
Amazon Managed Grafana ワークスペースのタグを使用するには、このセクションの手順を使用します。
**Topics**
# ワークスペースへのタグの追加
Amazon Managed Grafana ワークスペースにタグ (キーと値のペア) を追加すると、 AWS リソースの特定と整理に役立ちます。最初に、ワークスペースに 1 つ以上のタグを追加します。このタグを基にワークスペースへのアクセスを管理する IAM ポリシーを作成することができます。コンソールまたは AWS CLI を使用して、Amazon Managed Grafana ワークスペースにタグを追加できます。
**重要**
ワークスペースにタグを追加すると、そのワークスペースへのアクセスに影響が生じる可能性があります。ワークスペースにタグを追加する前に、タグを使用してリソースへのアクセスを制御している可能性のある IAM ポリシーをすべて確認してください。
Amazon Managed Grafana ワークスペースにタグを追加する方法については、「Amazon Managed Grafana User Guide」の「[Amazon Managed Grafana ワークスペースを作成する](AMG-create-workspace.md)」を参照してください。
------
#### [ Console ]
コンソールから Amazon Managed Grafana ワークスペースにタグ (複数可) を追加することができます。
1. Amazon Managed Grafana コンソール ([https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/)) を開きます。
1. 左側にあるナビゲーションペインで、[メニュー] アイコンを選択します。
1. **[すべてのワークスペース]** を選択します。
1. 管理するワークスペースのワークスペース ID を選択します。
1. **[タグ]** タブを選択します。
1. **[タグを管理]** を選択します。
1. **[キー]** フィールドにタグ名を入力します。**[値]** では、必要に応じて値にタグを追加することができます。
1. (オプション) 別のタグを追加するには、**[タグを追加]** を選択します。
1. タグの追加が完了したら、**[変更を保存]** を選択します。
------
#### [ CLI ]
CLI AWS を使用して Amazon Managed Grafana ワークスペースに 1 つ以上のタグを追加するには、次の手順に従います。
+ ターミナルまたはコマンドラインで、`tag-resource` コマンドを実行して、タグを追加するワークスペースの Amazon リソースネーム (ARN) と、追加するタグのキーおよび値を指定します。ワークスペースには 1 つ以上のタグを追加できます。以下に、Grafana ワークスペース *My-Workspace* に *[名前]*という名前のタグキーを *my\$1key\$1value *のタグ値でタグ付けする場合に実行するコマンドの例を示します:
```
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 「リソースのタグ付け](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)」を参照してください。
------
#### [ Console ]
コンソールを使用して、Amazon Managed Grafana ワークスペースに関連付けられているタグを表示できます。
1. Amazon Managed Grafana コンソール ([https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/)) を開きます。
1. 左側にあるナビゲーションペインで、[メニュー] アイコンを選択します。
1. **[すべてのワークスペース]** を選択します。
1. 管理するワークスペースのワークスペース ID を選択します。
1. **[タグ]** タブを選択します。
------
#### [ CLI ]
CLI AWS を使用して 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` API を組み合わせて使用します。
**重要**
Amazon Managed Grafana ワークスペースのタグを編集すると、そのワークスペースへのアクセス権に影響が及ぶ可能性があります。ワークスペースのタグを編集する前に、タグのキーや値を使用してリポジトリなどのリソースへのアクセスを制御する可能性のある IAM ポリシーを必ず確認してください。
------
#### [ Console ]
コンソールを使用して、Amazon Managed Grafana ワークスペースに関連付けられているタグを編集できます。
1. [Grafana コンソール](https://console.aws.amazon.com/grafana/)で Amazon Managed Grafana コンソールを開きます。
1. 左側にあるナビゲーションペインで、[メニュー] アイコンを選択します。
1. **[すべてのワークスペース]** を選択します。
1. 管理するワークスペースのワークスペース ID を選択します。
1. **[タグ]** タブを選択します。
1. **[タグを管理]** を選択します。
1. **[キー]** フィールドにタグ名を入力します。**[値]** では、必要に応じて値にタグを追加することができます。
1. タグの編集が完了したら、**[変更を保存]** を選択します。
------
#### [ CLI ]
を使用してワークスペースのタグ AWS CLI を更新するには、次の手順に従います。既存のキーの値を変更したり、別のキーを追加することができます。
ターミナルまたはコマンドラインで、**tag-resource** コマンドを実行して、タグを更新するAmazon Managed Grafana ワークスペースの Amazon リソースネーム (ARN) と、タグキーおよびタグ値を指定します。
例えば、タグの値を新しい値「*Key\$1value\$1new*」に変更するには、次のコマンドを実行します。
```
aws grafana tag-resource \
--resource-arn arn:aws:grafana:us-west-2:123456789012:/workspace/workspace-IDstring \
--tags "Name=Key_value_new"
```
タグのキーを新しい名前「*Name\$1new *」に変更するには、次のコマンドを実行します。
```
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 コンソール](https://console.aws.amazon.com/grafana/)で Amazon Managed Grafana コンソールを開きます。
1. 左側にあるナビゲーションペインで、[メニュー] アイコンを選択します。
1. **[すべてのワークスペース]** を選択します。
1. 管理するワークスペースのワークスペース ID を選択します。
1. **[タグ]** タブを選択します。
1. **[タグを管理]** を選択します。
1. 削除するタグを見つけて、**[削除]** を選択します。
1. タグの削除を終了したら、**[変更を保存]** を選択します。
------
#### [ CLI ]
を使用してワークスペースからタグ AWS CLI を削除するには、次の手順に従います。タグを削除しても他のリソースからそのタグがなくなるわけではありません。タグとワークスペースとの関連付けが解除されるだけです。
**注記**
Amazon Managed Grafana ワークスペースを削除すると、削除されたワークスペースからタグの関連付けがすべて解除されます。ワークスペースを削除する前にタグを削除する必要はありません。
ターミナルまたはコマンドラインで、**[untag-resource]** コマンドを実行して、タグを削除するワークスペースの Amazon リソースネーム (ARN) と、削除するタグのタグキーを指定します。例えば、*workspace-IDstring* という名前のワークスペースでタグキー *名前* を使用してタグを削除するには、次のコマンドを実行します。
```
aws grafana untag-resource --resoure-arn arn:aws:grafana:us-west-2:/workspaces/workspace-IDstring --tag-keys Items=Name
```
正常に実行されると、このコマンドは空のレスポンスを返します。ワークスペースに関連付けられたタグが削除されていることを確認するには、**[list-tags-for-resource]** コマンドを実行します。
------