CodeArtifact でパッケージグループにタグを付ける

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

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

パッケージグループにタグを付ける (CLI)

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

まだ設定していない場合は、「AWS CodeArtifact での設定」の手順に従って AWS CLI を設定してください。

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

パッケージグループにタグを追加する (CLI)

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

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

パッケージグループには 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)

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

ターミナルまたはコマンドラインで、パッケージグループの Amazon リソースネーム (ARN) を指定して list-tags-for-resource コマンドを実行します。パッケージグループの ARN については、「パッケージグループ ARN」を参照してください。

例えば、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)

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

ターミナルまたはコマンドラインで、tag-resource コマンドを実行して、タグを更新するパッケージグループの ARN、およびタグキーとタグ値を指定します。パッケージグループの ARN については、「パッケージグループ ARN」を参照してください。

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)

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

ターミナルまたはコマンドラインで、untag-resource コマンドを実行して、タグを削除するパッケージグループの ARN と、削除するタグのタグキーを指定します。パッケージグループの ARN については、「パッケージグループ ARN」を参照してください。

例えば、タグキー 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 コマンドを使用して表示できます。