翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# CodeArtifact でパッケージグループにタグを付ける
<a name="package-group-tags"></a>

タグは、AWS リソースに関連付けられるキーと値のペアです。CodeArtifact では、パッケージグループにタグを適用できます。CodeArtifact リソースのタグ付け、ユースケース、タグのキーと値の制約、サポートされているリソースタイプの詳細については、[リソースのタグ付け](tag-resources.md)を参照してください。

パッケージグループを作成するとき、または、既存のパッケージグループのタグ値を追加、削除、更新するときに CLI を使用してタグを指定できます。

## パッケージグループにタグを付ける (CLI)
<a name="package-group-tags-cli"></a>

CLI を使用してパッケージグループのタグを管理します。

まだ設定していない場合は、「[AWS CodeArtifact でのセットアップ](get-set-up-for-codeartifact.md)」の手順に従って AWS CLI を設定してください。

**ヒント**  
タグを追加するには、パッケージグループの Amazon リソースネーム (ARN) の指定が必要です。パッケージグループの ARN を取得するには、`describe-package-group` コマンドを実行します。  

```
aws codeartifact describe-package-group \
   --domain {{my_domain}} \
   --package-group {{/npm/scope/anycompany~}} \
   --query packageGroup.arn
```

**Topics**
+ [パッケージグループにタグを追加する (CLI)](#package-group-tags-add-cli)
+ [パッケージグループのタグを表示する (CLI)](#package-group-tags-list-cli)
+ [パッケージグループのタグを編集する (CLI)](#package-group-tags-edit-cli)
+ [パッケージグループからタグを削除する (CLI)](#package-group-tags-delete-cli)

### パッケージグループにタグを追加する (CLI)
<a name="package-group-tags-add-cli"></a>

タグは、パッケージグループの作成時に追加したり、既存のパッケージグループに追加したりできます。パッケージグループの作成時にタグを追加する方法については、「[パッケージグループを作成する](create-package-group.md)」を参照してください。

AWS CLI を使用して既存のパッケージグループにタグを追加するには、ターミナルまたはコマンドラインで、**tag-resource** コマンドを実行して、タグを追加するパッケージグループの Amazon リソースネーム (ARN) と、追加するタグのキーおよび値を指定します。パッケージグループの ARN については、「[パッケージグループ ARN](auth-and-access-control-permissions-reference.md#package-group-arns)」を参照してください。

パッケージグループには 1 つ以上のタグを追加できます。例えば、{{/npm/scope/anycompany\~}} という名前のパッケージグループに 2 つのタグを付けます。{{value1}} のタグ値がある {{key1}} という名前のタグキーと、{{value2}} のタグ値がある {{key2}} という名前のタグキーです。

```
aws codeartifact tag-resource \
   --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}} \
   --tags key={{key1}},value={{value1}} key={{key2}},value={{value2}}
```

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

### パッケージグループのタグを表示する (CLI)
<a name="package-group-tags-list-cli"></a>

AWS CLI を使用してパッケージグループの AWS タグを表示するには、以下の手順に従います。タグが追加されていない場合、返されるリストは空になります。

ターミナルまたはコマンドラインで、パッケージグループの Amazon リソースネーム (ARN) を指定して **list-tags-for-resource** コマンドを実行します。パッケージグループの ARN については、「[パッケージグループ ARN](auth-and-access-control-permissions-reference.md#package-group-arns)」を参照してください。

例えば、ARN 値が `arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}}` のパッケージグループ {{/npm/scope/anycompany\~}} のタグキーとタグ値のリストを表示する方法は次のとおりです。

```
aws codeartifact list-tags-for-resource \
   --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}}
```

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

```
{
    "tags": {
        "key1": "value1",
        "key2": "value2"
    }
}
```

### パッケージグループのタグを編集する (CLI)
<a name="package-group-tags-edit-cli"></a>

AWS CLI を使用してパッケージグループのタグを編集するには、以下の手順に従います。既存のキーの値を変更したり、別のキーを追加できます。次のセクションに示すように、パッケージグループからタグを削除することもできます。

ターミナルまたはコマンドラインで、**tag-resource** コマンドを実行して、タグを更新するパッケージグループの ARN、およびタグキーとタグ値を指定します。パッケージグループの ARN については、「[パッケージグループ ARN](auth-and-access-control-permissions-reference.md#package-group-arns)」を参照してください。

```
aws codeartifact tag-resource \
   --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}} \
   --tags key={{key1}},value={{newvalue1}}
```

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

### パッケージグループからタグを削除する (CLI)
<a name="package-group-tags-delete-cli"></a>

AWS CLI を使用してパッケージグループからタグを削除するには、以下の手順に従います。

**注記**  
パッケージグループを削除すると、削除されたパッケージグループのすべてのタグの関連付けが解除されます。パッケージグループを削除する前にタグを削除する必要はありません。

ターミナルまたはコマンドラインで、**untag-resource** コマンドを実行して、タグを削除するパッケージグループの ARN と、削除するタグのタグキーを指定します。パッケージグループの ARN については、「[パッケージグループ ARN](auth-and-access-control-permissions-reference.md#package-group-arns)」を参照してください。

例えば、タグキー {{key1}} と {{key2}} を使用して、パッケージグループ {{/npm/scope/anycompany\~}} の複数のタグを削除する方法は次のとおりです。

```
aws codeartifact untag-resource \
   --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}} \
   --tag-keys {{key1}} {{key2}}
```

成功した場合は、コマンドの出力はありません。タグを削除した後、パッケージグループに残っているタグは、`list-tags-for-resource` コマンドを使用して表示できます。