本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 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)。

在終端機或命令列上執行 **tag-resource** 命令，為您要新增標籤及該標籤之索引鍵和值的自訂動作，指定 Amazon Resource Name (ARN)。您可以將多個標籤新增到自訂動作。例如，若要以兩個標籤來標記自訂動作，一個標籤的索引鍵名為 {{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 CLI 檢視自訂動作的 AWS 標籤。若未新增標籤，傳回的清單空白。

在終端機或命令列上執行 **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 Resource Name (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 中移除標籤。當您從關聯的資源移除標籤時，將會刪除這些標籤。

**注意**  
如果您刪除自訂動作，所有標籤關聯都會從已刪除的自訂動作中移除。您不需要在刪除自訂動作之前移除標籤。

在終端機或命令列，執行 **untag-resource** 命令，為您要移除的標籤及其標籤索引鍵的自訂動作指定 ARN。例如，移除具有標籤索引鍵 {{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** 命令。