

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

# 在中标记自定义操作 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 资源名称 (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 资源名称 (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** 命令。