翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# タグ接続リソース
*タグ*は、 AWS リソース AWS に割り当てるカスタム属性ラベルです。各 AWS タグには 2 つの部分があります。
+ *タグキー* (例： `CostCenter`、`Environment`、または `Project`)。タグキーでは大文字と小文字が区別されます。
+ タグ値**と呼ばれるオプションのフィールド (`111122223333`、`Production`、チーム名など)。タグ値を省略すると、空の文字列を使用した場合と同じになります。タグキーと同様に、タグ値では大文字と小文字が区別されます。
これらは共に*キーと値のペア*と呼ばれます。
コンソールまたは CLI を使用して、リソースのタグ付けをします。
AWS CodeConnections では、次のリソースタイプにタグを付けることができます。
+ Connections
+ [ホスト]
これらのステップでは、 の最新バージョンが既にインストールされているか、最新バージョンに AWS CLI 更新されていることを前提としています。詳細については、「*AWS Command Line Interface ユーザーガイド*」の「[Installing the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)」を参照してください。
タグを使用してリソースを識別、整理、追跡するだけでなく、 AWS Identity and Access Management (IAM) ポリシーのタグを使用して、リソースを表示および操作できるユーザーを制御できます。タグベースのアクセスポリシーの例については、「[タグを使用して AWS CodeConnections リソースへのアクセスを制御する](connections-tag-based-access-control.md)」を参照してください。
**Topics**
+ [リソースのタグ付け (コンソール)](#connections-tag-console)
+ [タグリソース (CLI)](#connections-tag-cli)
## リソースのタグ付け (コンソール)
コンソールを使用して、接続リソースにタグを追加、更新、または削除できます。
**Topics**
+ [接続リソースにタグを追加する (コンソール)](#connections-tag-console-add)
+ [接続リソース (コンソール) のタグを表示する](#connections-tag-console-view)
+ [接続リソース (コンソール) のタグを編集する](#connections-tag-console-edit)
+ [接続リソースからのタグを削除する (コンソール)](#connections-tag-console-remove)
### 接続リソースにタグを追加する (コンソール)
コンソールを使用して、既存の接続またはホストにタグを追加します。
**注記**
GitHub Enterprise Server などのインストール済みプロバイダーの接続を作成し、ホストリソースも作成すると、作成中のタグはこの接続だけに追加されます。これにより、ホストを新しい接続で再利用する場合は、ホストに個別にタグを付けることができます。ホストにタグを追加するには、次の手順に従います。
****接続にタグを追加するには****
1. コンソールにサインインします。ナビゲーションパネルから [**Settings (設定)**] を選択します。
1. [**Settings**] (設定) で、[**Connections**] (接続) を選択します。[**Connections (接続)**] タブを選択します。
1. 編集する接続を選択します。接続設定のページが表示されます。
1. [**Connection tags**] (接続タグ) で、[**Edit**] (編集) を選択します。[**Edit Connection tags**] (接続タグの編集) ページが表示されます。
1. [**Key**] フィールドと [**Value**] フィールドに、追加するタグのセットごとにキーペアを入力します。( **[値]** フィールドはオプションです。) 例えば、**[キー]** では、「**Project**」と入力します。**[値]** には「**ProjectA**」と入力します。
1. (オプション) **[タグを追加]** をクリックして行を追加し、さらにタグを入力します。
1. [**Submit**] を選択してください。タグは、接続の設定の下に表示されます。
****ホストにタグを追加するには****
1. コンソールにサインインします。ナビゲーションパネルから [**Settings (設定)**] を選択します。
1. [**Settings**] (設定) で、[**Connections**] (接続) を選択します。[**Hosts**] (ホスト) タブを選択します。
1. 編集するホストを選択します。ホスト設定のページが表示されます。
1. [**Host tags**] (ホストタグ) で、[**Edit**] (編集) を選択します。[**Hosts Tag**] (ホストタグ) ページが表示されます。
1. [**Key**] フィールドと [**Value**] フィールドに、追加するタグのセットごとにキーペアを入力します。( **[値]** フィールドはオプションです。) 例えば、**[キー]** では、「**Project**」と入力します。**[値]** には「**ProjectA**」と入力します。
1. (オプション) [**Add tag**] (タグの追加) を選択して行を追加し、さらにホストのタグを入力します。
1. [**Submit**] を選択してください。タグは、ホストの設定の下に表示されます。
### 接続リソース (コンソール) のタグを表示する
コンソールを使用して、既存のリソースのタグを表示できます。
**接続のタグを表示するには**
1. コンソールにサインインします。ナビゲーションパネルから [**Settings (設定)**] を選択します。
1. [**Settings**] (設定) で、[**Connections**] (接続) を選択します。[**Connections (接続)**] タブを選択します。
1. 表示する接続を選択します。接続設定のページが表示されます。
1. [**Connection tags**] で、[**Key**] 列と [**Value**] 列下の接続のタグを表示します。
**ホストのタグを表示するには**
1. コンソールにサインインします。ナビゲーションパネルから [**Settings (設定)**] を選択します。
1. [**Settings**] (設定) で、[**Connections**] (接続) を選択します。[**Hosts**] (ホスト) タブを選択します。
1. 表示するホストを選択します。
1. [**Host tags**] で、[**Key**] 列と [**Value**] 列下のホストのタグを表示します。
### 接続リソース (コンソール) のタグを編集する
コンソールを使用して、接続リソースに追加されたタグを編集します。
**接続のタグを編集するには**
1. コンソールにサインインします。ナビゲーションパネルから [**Settings (設定)**] を選択します。
1. [**Settings**] (設定) で、[**Connections**] (接続) を選択します。[**Connections (接続)**] タブを選択します。
1. 編集する接続を選択します。接続設定のページが表示されます。
1. [**Connection tags**] (接続タグ) で、[**Edit**] (編集) を選択します。[**Connection tags**] (接続タグ) ページが表示されます。
1. **[キー]** フィールドと **[値]** フィールドに、必要に応じて各フィールドの値を更新します。例えば、**Project** キーの場合は、[**Value**] で、**ProjectA** を **ProjectB** に変更します。
1. [**Submit**] を選択してください。
**ホストのタグを編集するには**
1. コンソールにサインインします。ナビゲーションパネルから [**Settings (設定)**] を選択します。
1. [**Settings**] (設定) で、[**Connections**] (接続) を選択します。[**Hosts**] (ホスト) タブを選択します。
1. 編集するホストを選択します。ホスト設定のページが表示されます。
1. [**Host tags**] (ホストタグ) で、[**Edit**] (編集) を選択します。[**Hosts Tag**] (ホストタグ) ページが表示されます。
1. **[キー]** フィールドと **[値]** フィールドに、必要に応じて各フィールドの値を更新します。例えば、**Project** キーの場合は、[**Value**] で、**ProjectA** を **ProjectB** に変更します。
1. [**Submit**] を選択してください。
### 接続リソースからのタグを削除する (コンソール)
コンソールを使用して、接続リソースからタグを削除できます。関連付けられているリソースからタグを削除すると、そのタグが削除されます。
**接続のタグを削除するには**
1. コンソールにサインインします。ナビゲーションパネルから [**Settings (設定)**] を選択します。
1. [**Settings**] (設定) で、[**Connections**] (接続) を選択します。[**Connections (接続)**] タブを選択します。
1. 編集する接続を選択します。接続設定のページが表示されます。
1. [**Connection tags**] (接続タグ) で、[**Edit**] (編集) を選択します。[**Connection tags**] (接続タグ) ページが表示されます。
1. 削除する各タグのキーと値の横にある [**Remove tag**] を選択します。
1. [**Submit**] を選択してください。
**ホストのタグを削除するには**
1. コンソールにサインインします。ナビゲーションパネルから [**Settings (設定)**] を選択します。
1. [**Settings**] (設定) で、[**Connections**] (接続) を選択します。[**Hosts**] (ホスト) タブを選択します。
1. 編集するホストを選択します。ホスト設定のページが表示されます。
1. [**Host tags**] (ホストタグ) で、[**Edit**] (編集) を選択します。[**Hosts Tag**] (ホストタグ) ページが表示されます。
1. 削除する各タグのキーと値の横にある [**Remove tag**] を選択します。
1. [**Submit**] を選択してください。
## タグリソース (CLI)
CLI を使用して、接続リソースのタグを表示、追加、更新、または削除できます。
**Topics**
+ [接続リソースにタグを追加する (CLI)](#connections-tag-add)
+ [接続リソース (CLI) のタグを表示する](#connections-tag-view)
+ [接続リソース (CLI) のタグを編集する](#connections-tag-edit)
+ [接続リソース (CLI) からのタグを削除する](#connections-tag-delete)
### 接続リソースにタグを追加する (CLI)
を使用して AWS CLI 、接続内のリソースにタグを付けることができます。
ターミナルまたはコマンドラインで、タグを追加するリソースの Amazon リソースネーム (ARN)、および追加するタグのキーと値を指定して **tag-resource** コマンドを実行します。複数のタグを追加できます。
****接続にタグを追加するには****
1. リソースの ARN を取得します。[接続を一覧表示する](connections-list.md) に示されている **list-connections** コマンドを使用して、接続ARNを取得します。
1. ターミナルまたはコマンドラインで、**tag-resource** コマンドを実行します。
例えば、次のコマンドを使用して、接続に 2 つのタグ、{{Project}} という名前のタグキーに {{ProjectA}} のタグ値、および {{ReadOnly}} という名前のタグキーに {{true}} のタグ値を付けます。
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key={{Project}},Value={{ProjectA}} Key={{IscontainerBased}},Value={{true}}
```
成功した場合、このコマンドは何も返しません。
****ホストにタグを追加するには****
1. リソースの ARN を取得します。[ホストを一覧表示](connections-host-list.md) に示されている **list-hosts** コマンドを使用して、ホスト ARN を取得します。
1. ターミナルまたはコマンドラインで、**tag-resource** コマンドを実行します。
例えば、次のコマンドを使用して、ホストに 2 つのタグ、{{Project}} という名前のタグキーに {{ProjectA}} のタグ値、および {{IscontainerBased}} という名前のタグキーに {{true}} のタグ値を付けます。
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:host/My-Host-28aef605 --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true
```
成功した場合、このコマンドは何も返しません。
### 接続リソース (CLI) のタグを表示する
を使用して AWS CLI 、接続リソースの AWS タグを表示できます。タグが追加されていない場合、返されるリストは空になります。を使用する **list-tags-for-resource** コマンドを使用して、接続またはホストに追加されたタグを表示します。
****接続のタグを表示するには****
1. リソースの ARN を取得します。[接続を一覧表示する](connections-list.md) に示されている **list-connections** コマンドを使用して、接続ARNを取得します。
1. ターミナルまたはコマンドラインで、**list-tags-for-resource** コマンドを実行します。例えば、接続のタグキーとタグ値の一覧を表示するには、次のコマンドを使用します。
```
aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f
```
このコマンドは、リソースに関連付けられているタグを返します。この例は、接続に対して返される 2 つのキーと値のペアを示しています。
```
{
"Tags": [
{
"Key": "Project",
"Value": "ProjectA"
},
{
"Key": "ReadOnly",
"Value": "true"
}
]
}
```
****ホストのタグを表示するには****
1. リソースの ARN を取得します。[ホストを一覧表示](connections-host-list.md) に示されている **list-hosts** コマンドを使用して、ホスト ARN を取得します。
1. ターミナルまたはコマンドラインで、**list-tags-for-resource** コマンドを実行します。例えば、 ホストのタグキーとタグ値の一覧を表示するには、次のコマンドを使用します。
```
aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:host/My-Host-28aef605
```
このコマンドは、リソースに関連付けられているタグを返します。この例は、ホストに対して返される 2 つのキーと値のペアを示しています。
```
{
"Tags": [
{
"Key": "IscontainerBased",
"Value": "true"
},
{
"Key": "Project",
"Value": "ProjectA"
}
]
}
```
### 接続リソース (CLI) のタグを編集する
を使用して AWS CLI 、リソースのタグを編集できます。既存のキーの値を変更したり、別のキーを追加できます。
ターミナルまたはコマンドラインで、タグを更新するリソースの ARN を指定して、**tag-resource** コマンドを実行し、更新するタグキーとタグ値を指定します。
タグを編集すると、指定されていないタグキーは保持されますが、同じキーで新しい値を持つものはすべて更新されます。edit コマンドで追加された新しいキーは、新しいキーと値のペアとして追加されます。
****接続のタグを編集するには****
1. リソースの ARN を取得します。[接続を一覧表示する](connections-list.md) に示されている **list-connections** コマンドを使用して、接続ARNを取得します。
1. ターミナルまたはコマンドラインで、**tag-resource** コマンドを実行します。
この例では、キーの値 `Project` が `ProjectB` に変更されています。
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectB
```
成功した場合、このコマンドは何も返しません。接続に関連付けられているタグを確認するには、**list-tags-for-resource** コマンドを実行します。
****ホストのタグを編集するには****
1. リソースの ARN を取得します。[ホストを一覧表示](connections-host-list.md) に示されている **list-hosts** コマンドを使用して、ホスト ARN を取得します。
1. ターミナルまたはコマンドラインで、**tag-resource** コマンドを実行します。
この例では、キーの値 `Project` が `ProjectB` に変更されています。
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:host/My-Host-28aef605 --tags Key=Project,Value=ProjectB
```
成功した場合、このコマンドは何も返しません。ホストに関連付けられているタグを確認するには、**list-tags-for-resource** コマンドを実行します。
### 接続リソース (CLI) からのタグを削除する
を使用してリソースからタグ AWS CLI を削除するには、次の手順に従います。関連付けられているリソースからタグを削除すると、そのタグが削除されます。
**注記**
接続リソースを削除すると、削除されたリソースからすべてのタグの関連付けが削除されます。接続リソースを削除する前に、タグを削除する必要はありません。
ターミナルまたはコマンドラインで、タグを削除するリソースの ARN と削除するタグのタグキーを指定して、**untag-resource** コマンドを実行します。例えば、タグキー {{Project}} および {{ReadOnly}} を持つ接続の複数のタグを削除するには、次のコマンドを使用します。
```
aws codestar-connections untag-resource --resource-arn arn:aws:codestar-connections:us-west-2:{{account_id}}:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tag-keys {{Project}} {{ReadOnly}}
```
成功した場合、このコマンドは何も返しません。リソースに関連付けられているタグを確認するには、**list-tags-for-resource** コマンドを実行します。出力は、すべてのタグが削除されたことを示しています。
```
{
"Tags": []
}
```