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

# 在 CodePipeline 中標記管道
<a name="pipelines-tag"></a>

標籤是與 AWS 資源相關聯的鍵/值對。您可以在 CodePipeline 中將標籤套用至管道。如需 CodePipeline 資源標記、使用案例、標籤索引鍵和值限制，以及支援的資源類型的詳細資訊，請參閱 [標記 資源](tag-resources.md)。

建立管道時，您可以使用 CLI 指定標籤。您可以使用主控台或 CLI 來新增或移除標籤，並更新管道中標籤的值。您可以對新增最多 50 個標籤到各管道。

**Topics**
+ [標記管道 (主控台)](#pipelines-tag-console)
+ [標記管道 (CLI)](#pipelines-tag-cli)

## 標記管道 (主控台)
<a name="pipelines-tag-console"></a>

您可以使用主控台或 CLI 以標記資源。管道是唯一可以使用主控台或 CLI 管理的 CodePipeline 資源。

**Topics**
+ [新增標籤到管道 (主控台)](#pipelines-tag-add-console)
+ [檢視管道標籤 (主控台)](#pipelines-tag-list-console)
+ [編輯管道標籤 (主控台)](#pipelines-tag-update-console)
+ [從管道移除標籤 (主控台)](#pipelines-tag-delete-console)

### 新增標籤到管道 (主控台)
<a name="pipelines-tag-add-console"></a>

您可以使用主控台，將標籤新增到現有管道。

1. 登入 AWS 管理主控台 並開啟 CodePipeline 主控台，網址為 https：//[http://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home)。

1. 在 **Pipelines (管道)** 頁面，選擇您要新增標籤的管道。

1. 從導覽窗格中，選擇 **Settings (設定)**。

1. 在 **Pipeline tags (管道標籤)** 中，選擇 **Edit (編輯)**。

1. 在 **Key (索引鍵)** 和Value**Value (值)** 欄中，在你想新增的各組標籤中輸入金鑰對。(**Value (值)** 欄為選用。) 例如，在 **Key (索引鍵)** 中輸入 **Project**。在 **Value (值)** 中輸入 **ProjectA**。

1. (選用) 選擇 **Add tag (新增標籤)**，新增更多列，然後輸入更多標籤。

1. 選擇**提交**。標籤列在管道設定之下。

### 檢視管道標籤 (主控台)
<a name="pipelines-tag-list-console"></a>

您可以使用主控台列出現有管道的標籤。

1. 登入 AWS 管理主控台 並開啟 CodePipeline 主控台，網址為 https：//[http://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home)。

1. 在 **Pipelines (管道)** 頁面，選擇您要檢視標籤的管道。

1. 從導覽窗格中，選擇 **Settings (設定)**。

1. 在 **Pipeline tags (管道標籤)**下，檢視 **Key (金鑰)** 和 **Value (值)** 欄下的管道標籤。

### 編輯管道標籤 (主控台)
<a name="pipelines-tag-update-console"></a>

您可以使用主控台來編輯已新增到管道的標籤。

1. 登入 AWS 管理主控台 並開啟 CodePipeline 主控台，網址為 https：//[http://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home)。

1. 在 **Pipelines (管道)** 頁面，選擇您想更新標籤的管道。

1. 從導覽窗格中，選擇 **Settings (設定)**。

1. 在 **Pipeline tags (管道標籤)** 中，選擇 **Edit (編輯)**。

1. 在 **Key (金鑰)** 和 **Value (加值)** 欄，視需要更新每個欄位的值。例如，針對 **Project** 索引鍵，在 **Value (值)** 中將 **ProjectA** 變為 **ProjectB**。

1. 選擇**提交**。

### 從管道移除標籤 (主控台)
<a name="pipelines-tag-delete-console"></a>

您可以使用主控台，從管道刪除標籤。當您從關聯的資源移除標籤時，將會刪除這些標籤。

1. 登入 AWS 管理主控台 並開啟 CodePipeline 主控台，網址為 https：//[http://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home)。

1. 在 **管道 (Pipelines)** 頁面，選擇您要移除標籤的管道。

1. 從導覽窗格中，選擇 **Settings (設定)**。

1. 在 **Pipeline tags (管道標籤)** 中，選擇 **Edit (編輯)**。

1. 在您要刪除的金鑰和值的每個標籤旁邊，選擇 **移除標籤 (Remove tag)**。

1. 選擇**提交**。

## 標記管道 (CLI)
<a name="pipelines-tag-cli"></a>

您可以使用 CLI 標籤資源。您必須使用主控台，管理管道中的標籤。

**Topics**
+ [新增標籤到管道 (CLI)](#pipelines-tag-add-cli)
+ [檢視管道標籤 (CLI)](#pipelines-tag-list-cli)
+ [編輯管道標籤 (CLI)](#pipelines-tag-update-cli)
+ [從管道移除標籤 (CLI)](#pipelines-tag-delete-cli)

### 新增標籤到管道 (CLI)
<a name="pipelines-tag-add-cli"></a>

您可以使用 主控台或 AWS CLI 來標記管道。

若要在建立時將標籤新增到管道，請參閱 [建立管道、階段和動作](pipelines-create.md)。

在這些步驟中，我們假設您已經安裝新版 AWS CLI 或更新到最新版本。如需詳細資訊，請參閱[安裝 AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)。

在終端機或命令列，執行 **tag-resource** 命令，指定您要新增的管道 Amazon Resource Name (ARN)，和您想新增標籤的金鑰和值。您可以新增多個標籤到管道。例如，若要使用兩個標籤標記名為 *MyPipeline* 的管道、使用 *Test* 標籤值命名為 *DeploymentEnvironment* 的標籤金鑰，以及使用 *true* 標籤值命名為 *IscontainerBased* 的標籤金鑰：

```
aws codepipeline tag-resource --resource-arn arn:aws:codepipeline:us-west-2:account-id:MyPipeline --tags key=Project,value=ProjectA key=IscontainerBased,value=true
```

若成功，此命令不會傳回任何內容。

### 檢視管道標籤 (CLI)
<a name="pipelines-tag-list-cli"></a>

請依照下列步驟使用 AWS CLI 來檢視管道的 AWS 標籤。若未新增標籤，傳回的清單空白。

在終端機或命令列上執行 **list-tags-for-resource** 命令。例如，若要使用 `arn:aws:codepipeline:us-west-2:account-id:MyPipeline` ARN 值檢視名為 *MyPipeline* 之管道的標籤索引鍵和標籤值清單：

```
aws codepipeline list-tags-for-resource --resource-arn arn:aws:codepipeline:us-west-2:account-id:MyPipeline
```

若成功，此命令會傳回類似如下的資訊：

```
{
    "tags": {
        "Project": "ProjectA",
        "IscontainerBased": "true"
    }
}
```

### 編輯管道標籤 (CLI)
<a name="pipelines-tag-update-cli"></a>

請依照下列步驟使用 AWS CLI 編輯管道的標籤。您可以變更現有索引鍵的值或新增其他索引鍵。您也可以從管道移除標籤，如以下部分所示。

在終端機或命令列，執行 **tag-resource** 命令，指定您要更新標籤的管道 ARN，並指定標籤金鑰和標籤值：

```
aws codepipeline tag-resource --resource-arn arn:aws:codepipeline:us-west-2:account-id:MyPipeline --tags key=Project,value=ProjectA
```

若成功，此命令不會傳回任何內容。

### 從管道移除標籤 (CLI)
<a name="pipelines-tag-delete-cli"></a>

請依照下列步驟，使用 從管道 AWS CLI 移除標籤。當您從關聯的資源移除標籤時，將會刪除這些標籤。

**注意**  
如果您刪除管道，所有標籤關聯會從已刪除的管道中移除。刪除刪除管道後就不需要移除標籤了。

在終端機或命令列，執行 **untag-resource** 命令，指定您想移除標籤的管道 ARN，和您想移除的標籤的標籤金鑰。例如，若要使用標籤索引鍵 *Project* 和 *IscontainerBased* 在名為 *MyPipeline* 的管道上移除多個標籤：

```
aws codepipeline untag-resource --resource-arn arn:aws:codepipeline:us-west-2:account-id:MyPipeline --tag-keys Project IscontainerBased
```

若成功，此命令不會傳回任何內容。若要驗證與管道相關的標籤，請執行 **list-tags-for-resource** 命令。