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

# 在 CodeArtifact 中标记程序包组
<a name="package-group-tags"></a>

标签是与 AWS 资源关联的键/值对。您可以在 CodeArtifact 中向程序包组应用标签。有关 CodeArtifact 资源标记、使用场景、标签键和值约束以及支持的资源类型的信息，请参阅[为资源添加标签](tag-resources.md)。

创建程序包组或者添加、删除或更新现有程序包组的标签值时，可以使用 CLI 来指定标签。

## 标记程序包组（CLI）
<a name="package-group-tags-cli"></a>

您可以使用 CLI 来管理程序包组标签。

如果还没有配置 AWS CLI，请按照[使用进行设置 AWS CodeArtifact](get-set-up-for-codeartifact.md)中的步骤进行配置。

**提示**  
要添加标签，您必须提供程序包组的 Amazon 资源名称（ARN）。要获取程序包组的 ARN，请运行 `describe-package-group` 命令：  

```
aws codeartifact describe-package-group \
   --domain {{my_domain}} \
   --package-group {{/npm/scope/anycompany~}} \
   --query packageGroup.arn
```

**Topics**
+ [为程序包组添加标签（CLI）](#package-group-tags-add-cli)
+ [查看程序包组的标签（CLI）](#package-group-tags-list-cli)
+ [编辑程序包组的标签（CLI）](#package-group-tags-edit-cli)
+ [从程序包组中删除标签（CLI）](#package-group-tags-delete-cli)

### 为程序包组添加标签（CLI）
<a name="package-group-tags-add-cli"></a>

您可以在创建程序包组时为其添加标签，也可以为现有程序包组添加标签。有关在创建程序包组时为其添加标签的信息，请参阅[创建程序包组](create-package-group.md)。

要使用 AWS CLI 为现有程序包组添加标签，请在终端或命令行运行 **tag-resource** 命令，指定要为其添加标签的程序包组的 Amazon 资源名称（ARN），以及要添加的标签的键/值。有关程序包组 ARN 的信息，请参阅[Package 组 ARNs](auth-and-access-control-permissions-reference.md#package-group-arns)。

您可以为程序包组添加多个标签。例如，要为程序包组 {{/npm/scope/anycompany\~}} 添加两个标签，一个标签键名为 {{key1}}，标签值为 {{value1}}，另一个标签键名为 {{key2}}，标签值为 {{value2}}，请运行以下命令：

```
aws codeartifact tag-resource \
   --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}} \
   --tags key={{key1}},value={{value1}} key={{key2}},value={{value2}}
```

如果成功，此命令没有输出。

### 查看程序包组的标签（CLI）
<a name="package-group-tags-list-cli"></a>

按照以下步骤使用 AWS CLI 来查看程序包组的 AWS 标签。如果尚未添加标签，则返回的列表为空。

在终端或命令行中，使用程序包组的 Amazon 资源名称（ARN）运行 **list-tags-for-resource** 命令。有关程序包组 ARN 的信息，请参阅[Package 组 ARNs](auth-and-access-control-permissions-reference.md#package-group-arns)。

例如，要查看名为 {{/npm/scope/anycompany\~}} 且 ARN 值为 `arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}}` 的程序包组的标签键和标签值列表，请运行以下命令：

```
aws codeartifact list-tags-for-resource \
   --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}}
```

如果成功，该命令返回类似以下内容的信息：

```
{
    "tags": {
        "key1": "value1",
        "key2": "value2"
    }
}
```

### 编辑程序包组的标签（CLI）
<a name="package-group-tags-edit-cli"></a>

执行以下步骤，使用 AWS CLI 编辑程序包组的标签。您可以更改现有键的值或添加另一个键。您还可以从程序包组中删除标签，如下一节所示。

在终端或命令行运行 **tag-resource** 命令，指定要为其更新标签的程序包组的 ARN 并指定标签键和标签值。有关程序包组 ARN 的信息，请参阅[Package 组 ARNs](auth-and-access-control-permissions-reference.md#package-group-arns)。

```
aws codeartifact tag-resource \
   --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}} \
   --tags key={{key1}},value={{newvalue1}}
```

如果成功，此命令没有输出。

### 从程序包组中删除标签（CLI）
<a name="package-group-tags-delete-cli"></a>

可以按照以下步骤，使用 AWS CLI 从程序包组中删除标签。

**注意**  
如果删除程序包组，则系统会从删除的程序包组中删除所有标签关联。您无需在删除程序包组之前删除标签。

在终端或命令行运行 **untag-resource** 命令，指定要从中删除标签的程序包组的 ARN 以及要删除的标签的标签键。有关程序包组 ARN 的信息，请参阅[Package 组 ARNs](auth-and-access-control-permissions-reference.md#package-group-arns)。

例如，要删除程序包组 {{/npm/scope/anycompany\~}} 上的多个标签，标签键为 {{key1}} 和 {{key2}}，请运行以下命令：

```
aws codeartifact untag-resource \
   --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}} \
   --tag-keys {{key1}} {{key2}}
```

如果成功，此命令没有输出。删除标签后，您可以使用 `list-tags-for-resource` 命令查看程序包组上剩余的标签。