

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

# 将域名标记为 CodeArtifact
<a name="tag-domains"></a>

标签是与 AWS 资源关联的键/值对。您可以在中将标签应用于您的域名 CodeArtifact。有关 CodeArtifact 资源标记、用例、标签键和值限制以及支持的资源类型的信息，请参阅[为资源添加标签](tag-resources.md)。

您可以使用 CLI 在创建域时指定标签。您可以使用控制台或 CLI 来添加或删除标签，以及更新域中标签的值。您最多可以为每个域添加 50 个标签。

**Topics**
+ [标记域 (CLI)](#tag-domains-tag-cli)
+ [标记域（控制台）](#tag-domains-console)

## 标记域 (CLI)
<a name="tag-domains-tag-cli"></a>

您可以使用 CLI 来管理域标签。

**Topics**
+ [向域添加标签 (CLI)](#add-domains-tag-cli)
+ [查看域的标签 (CLI)](#list-domains-tag-cli)
+ [编辑域的标签 (CLI)](#update-domains-tag-cli)
+ [从域中删除标签 (CLI)](#delete-domains-tag-cli)

### 向域添加标签 (CLI)
<a name="add-domains-tag-cli"></a>

您可以使用控制台或 AWS CLI 来标记域名。

要在创建域时为其添加标签，请参阅[创建 存储库](create-repo.md)。

在这些步骤中，我们假设您已安装最新版本的 AWS CLI 或已更新到当前版本。有关更多信息，请参阅[安装 AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)。

在终端或命令行运行 **tag-resource** 命令，指定要为其添加标签的域的 Amazon 资源名称 (ARN)，以及要添加的标签的键/值。

**注意**  
要获取域的 ARN，请运行 `describe-domain` 命令：  

```
aws codeartifact describe-domain --domain my_domain --query domain.arn
```

您可以为域添加多个标签。例如，要*my\$1domain*使用两个标签来标记一个名为的域名*key1*，一个标签键的标签值为*value1*，一个标签键*key2*的标签值为*value2*：

```
aws codeartifact tag-resource --resource-arn arn:aws:codeartifact:us-west-2:123456789012:domain/my_domain --tags key=key1,value=value1 key=key2,value=value2
```

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

### 查看域的标签 (CLI)
<a name="list-domains-tag-cli"></a>

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

在终端或命令行中，使用域的 Amazon 资源名称 (ARN) 运行 **list-tags-for-resource** 命令。

**注意**  
要获取域的 ARN，请运行 `describe-domain` 命令：  

```
aws codeartifact describe-domain --domain my_domain --query domain.arn
```

例如，要查看*my\$1domain*以 `arn:aws:codeartifact:us-west-2:123456789012:domain/my_domain` ARN 值命名的域的标签键和标签值列表，请执行以下操作：

```
aws codeartifact list-tags-for-resource --resource-arn arn:aws:codeartifact:us-west-2:123456789012:domain/my_domain
```

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

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

### 编辑域的标签 (CLI)
<a name="update-domains-tag-cli"></a>

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

在终端或命令行运行 **tag-resource** 命令，指定要为其更新标签的域的 ARN 并指定标签键和标签值：

**注意**  
要获取域的 ARN，请运行 `describe-domain` 命令：  

```
aws codeartifact describe-domain --domain my_domain --query domain.arn
```

```
aws codeartifact tag-resource --resource-arn arn:aws:codeartifact:us-west-2:123456789012:domain/my_domain --tags key=key1,value=newvalue1
```

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

### 从域中删除标签 (CLI)
<a name="delete-domains-tag-cli"></a>

按照以下步骤使用从 AWS CLI 网域中移除标签。

**注意**  
如果您删除某个域，则会从已删除域中移除所有标签关联。您无需在删除域之前移除标签。

在终端或命令行运行 **untag-resource** 命令，指定要从中删除标签的域的 ARN 以及要删除的标签的标签键。

**注意**  
要获取域的 ARN，请运行 `describe-domain` 命令：  

```
aws codeartifact describe-domain --domain my_domain --query domain.arn
```

例如，要在名为的域名上移除多个标签，*mydomain*使用标签键*key1*和*key2*：

```
aws codeartifact untag-resource --resource-arn arn:aws:codeartifact:us-west-2:123456789012:domain/my_domain --tag-keys key1 key2
```

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

## 标记域（控制台）
<a name="tag-domains-console"></a>

您可以使用控制台或 CLI 来标记资源。

**Topics**
+ [为域添加标签（控制台）](#add-tag-domains-console)
+ [查看域的标签（控制台）](#list-tag-domains-console)
+ [编辑域的标签（控制台）](#update-tag-domains-console)
+ [从域中删除标签（控制台）](#delete-tag-domains-console)

### 为域添加标签（控制台）
<a name="add-tag-domains-console"></a>

您可以使用控制台向现有域添加标签。

1. 在 [https://console.aws.amazon.com/codesuite/codeartifact](https://console.aws.amazon.com/codesuite/codeartifact/home) /hom AWS CodeArtifact e 打开控制台。

1. 在**域**页面上，选择要添加标签的域。

1. 展开**详细信息**部分。

1. 在**域标签**下面，如果域没有标签，请选择**添加域标签**，如果有标签，则选择**查看和编辑域标签**。

1. 选择**添加新标签**。

1. 在**键**和**值**字段中，输入要添加的每个标签的文本。（**值**字段为可选项。） 例如，在**键**中，输入 **Name**。在**值**中，输入 **Test**。  
![\[域配置。\]](http://docs.aws.amazon.com/zh_cn/codeartifact/latest/ug/images/domain-add-tag-console.png)

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

1. 选择**更新域**。

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

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

1. 在 [https://console.aws.amazon.com/codesuite/codeartifact](https://console.aws.amazon.com/codesuite/codeartifact/home) /hom AWS CodeArtifact e 打开控制台。

1. 在**域**页面上，选择要查看标签的域。

1. 展开**详细信息**部分。

1. 在**域标签**下面，选择**查看和编辑域标签**。
**注意**  
如果未向此域添加任何标签，则控制台会显示**添加域标签**。

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

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

1. 在 [https://console.aws.amazon.com/codesuite/codeartifact](https://console.aws.amazon.com/codesuite/codeartifact/home) /hom AWS CodeArtifact e 打开控制台。

1. 在**域**页面上，选择要更新标签的域。

1. 展开**详细信息**部分。

1. 在**域标签**下面，选择**查看和编辑域标签**。
**注意**  
如果未向此域添加任何标签，则控制台会显示**添加域标签**。

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

1. 选择**更新域**。

### 从域中删除标签（控制台）
<a name="delete-tag-domains-console"></a>

您可以使用控制台从域中删除标签。

1. 在 [https://console.aws.amazon.com/codesuite/codeartifact](https://console.aws.amazon.com/codesuite/codeartifact/home) /hom AWS CodeArtifact e 打开控制台。

1. 在**域**页面上，选择要删除标签的域。

1. 展开**详细信息**部分。

1. 在**域标签**下面，选择**查看和编辑域标签**。
**注意**  
如果未向此域添加任何标签，则控制台会显示**添加域标签**。

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

1. 选择**更新域**。