本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 将管道标记为 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 控制台，[网址为 http://console.aws.amazon。 com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home)。

1. 在 **Pipelines (管道)** 页面上，选择您要向其添加标签的管道。

1. 从导航窗格中，选择**设置**。

1. 在 **Pipeline tags (管道标签)** 中，选择 **Edit (编辑)**。

1. 在**键**和**值**字段中，输入您要添加的每组标签的键/值对。（**值**字段为可选项。） 例如，在**键**中，输入 **Project**。在**值**中，输入 **ProjectA**。

1. （可选）选择**添加标签**以添加多行并输入多个标签。

1. 选择 **Submit (提交)**。标签在管道设置下列出。

### 查看管道的标签（控制台）
<a name="pipelines-tag-list-console"></a>

您可以使用控制台列出现有管道的标签。

1. 登录 AWS 管理控制台 并打开 CodePipeline 控制台，[网址为 http://console.aws.amazon。 com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home)。

1. 在 **Pipelines (管道)** 页面上，选择您要查看其标签的管道。

1. 从导航窗格中，选择**设置**。

1. 在 **Pipeline tags (管道标签)** 下，在 **Key (键)** 和 **Value (值)** 列下查看管道的标签。

### 编辑管道的标签（控制台）
<a name="pipelines-tag-update-console"></a>

您可以使用控制台来编辑已添加到管道的标签。

1. 登录 AWS 管理控制台 并打开 CodePipeline 控制台，[网址为 http://console.aws.amazon。 com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home)。

1. 在 **Pipelines (管道)** 页面上，选择您要更新其标签的管道。

1. 从导航窗格中，选择**设置**。

1. 在 **Pipeline tags (管道标签)** 中，选择 **Edit (编辑)**。

1. 在**键**和**值**字段中，根据需要更新每个字段的值。例如，对于 **Project** 键，在**值**中，将 **ProjectA** 更改为 **ProjectB**。

1. 选择 **Submit (提交)**。

### 删除管道的标签（控制台）
<a name="pipelines-tag-delete-console"></a>

您可以使用控制台从管道删除标签。当您移除关联资源的标签时，对应标签会被删除。

1. 登录 AWS 管理控制台 并打开 CodePipeline 控制台，[网址为 http://console.aws.amazon。 com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home)。

1. 在 **Pipelines (管道)** 页面上，选择您要删除其标签的管道。

1. 从导航窗格中，选择**设置**。

1. 在 **Pipeline tags (管道标签)** 中，选择 **Edit (编辑)**。

1. 接下来，对于您要删除的每个标签的键和值，选择**删除标签**。

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 资源名称 (ARN)，以及要添加的标签的键/值。您可以为管道添加多个标签。例如，要*MyPipeline*使用两个标签来标记名为的管道，一个标签键*DeploymentEnvironment*的标签值为*Test*，一个标签键*IscontainerBased*的标签值为*true*：

```
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** 命令。例如，要查看*MyPipeline*以 `arn:aws:codepipeline:us-west-2:account-id:MyPipeline` ARN 值命名的管道的标签键和标签值列表，请执行以下操作：

```
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 以及要删除的标签的标签键。例如，要在名*MyPipeline*为标签键的管道上删除多个标签，*Project*然后*IscontainerBased*：

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

如果成功，该命令不返回任何内容。要验证与管道关联的标签，请运行 **list-tags-for-resource** 命令。