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

# CodePipeline でカスタムアクションにタグ付けする
<a name="customactions-tag"></a>

タグは、 AWS リソースに関連付けられたキーと値のペアです。コンソールまたは CLI を使用して、CodePipelineでカスタムアクションにタグを適用できます。CodePipeline リソースのタグ付け、使用例、タグのキーと値の制約、サポートされているリソースの種類については、[リソースのタグ付け](tag-resources.md) を参照してください。

カスタムアクションのタグの値を追加、削除、更新することができます。各カスタムアクションには、最大 50 個のタグを追加できます。

**Topics**
+ [カスタムアクションにタグを追加する](#customactions-tag-add)
+ [カスタムアクションのタグを表示する](#customactions-tag-list)
+ [カスタムアクションのタグを編集する](#customactions-tag-update)
+ [カスタムアクションからタグを削除する](#customactions-tag-delete)

## カスタムアクションにタグを追加する
<a name="customactions-tag-add"></a>

を使用してカスタムアクションにタグ AWS CLI を追加するには、次の手順に従います。作成時にカスタムアクションにタグを追加するには、「[CodePipeline でカスタムアクションを作成および追加する](actions-create-custom-action.md)」を参照してください。

以下のステップでは、 AWS CLI の最新版を既にインストールしているか、最新版に更新しているものと想定します。詳細については、「[AWS Command Line Interfaceのインストール](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)」を参照してください。

ターミナルまたはコマンドラインで、タグを追加するカスタムアクションの Amazon リソースネーム (ARN)、および追加するタグのキーと値を指定して **tag-resource** コマンドを実行します。1 つのカスタムアクションに複数のタグを追加できます。例えば、2 つのタグがあるカスタムアクションにタグ付けするには、{{TestActionType}} というタグキーで {{UnitTest}} というタグ値を、また {{ApplicationName}} というタグキーで {{MyApplication}} というタグ値を指定します。

```
aws codepipeline tag-resource --resource-arn arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:actiontype:{{Owner}}/{{Category}}/{{Provider}}/{{Version}} --tags key={{TestActionType}},value={{UnitTest}} key={{ApplicationName}},value={{MyApplication}}
```

成功した場合、このコマンドは何も返しません。

## カスタムアクションのタグを表示する
<a name="customactions-tag-list"></a>

を使用してカスタムアクションの AWS タグ AWS CLI を表示するには、次の手順に従います。タグが追加されていない場合、返されるリストは空になります。

ターミナルまたはコマンドラインで、**list-tags-for-resource** コマンドを実行します。たとえば、ARN `arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:actiontype:{{Owner}}/{{Category}}/{{Provider}}/{{Version}}` を持つカスタムアクションのタグキーとタグ値のリストを表示するには、次のように入力します。

```
aws codepipeline list-tags-for-resource --resource-arn arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:actiontype:{{Owner}}/{{Category}}/{{Provider}}/{{Version}}
```

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

```
{
    "tags": {
        "TestActionType": "UnitTest",
        "ApplicationName": "MyApplication"
    }
}
```

## カスタムアクションのタグを編集する
<a name="customactions-tag-update"></a>

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

端末またはコマンドラインで、**tag-resource** コマンドを実行して、タグを更新するカスタムアクションの Amazon リソースネーム (ARN) を指定し、タグキーとタグ値を指定します。

```
aws codepipeline tag-resource --resource-arn arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:actiontype:{{Owner}}/{{Category}}/{{Provider}}/{{Version}} --tags key={{TestActionType}},value={{IntegrationTest}}
```

## カスタムアクションからタグを削除する
<a name="customactions-tag-delete"></a>

を使用してカスタムアクションからタグ AWS CLI を削除するには、次の手順に従います。関連付けられているリソースからタグを削除すると、そのタグが削除されます。

**注記**  
カスタムアクションを削除すると、削除されたカスタムアクションからすべてのタグの関連付けが削除されます。カスタムアクションを削除する前にタグを削除する必要はありません。

ターミナルまたはコマンド行で、タグを削除するカスタムアクションの ARN と削除するタグのタグキーを指定して、**untag-resource** コマンドを実行します。たとえば、タグキー {{TestActionType}} があるカスタムアクションでタグを削除するには、次のように入力します。

```
aws codepipeline untag-resource --resource-arn arn:aws:codepipeline:{{us-west-2}}:{{account-id}}:actiontype:{{Owner}}/{{Category}}/{{Provider}}/{{Version}} --tag-keys {{TestActionType}}
```

成功した場合、このコマンドは何も返しません。カスタムアクションに関連付けられているタグを確認するには、**list-tags-for-resource** コマンドを実行します。