本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 为连接资源添加标签
*标签*是您或 AWS 分配给 AWS 资源的自定义属性标签。每个 AWS 标签分为两部分：
+ *标签键*（例如，`CostCenter`、`Environment` 或 `Project`）。标签密钥区分大小写。
+ 一个称为*标签值*的可选字段（例如，`111122223333`、`Production` 或团队名称）。省略标签值与使用空字符串效果相同。与标签键一样，标签值区分大小写。
这些被统称为*键/值对*。
您可以使用控制台或 CLI 来标记资源。
您可以在 AWS 中标记以下资源类型 CodeConnections：
+ Connections
+ 主机
这些步骤假设您已经安装了的最新版本 AWS CLI 或已更新到当前版本。有关更多信息，请参阅《AWS Command Line Interface 用户指南》**中的[安装 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)。
除了使用标签识别、组织和跟踪您的资源外，您还可以在 AWS Identity and Access Management (IAM) 策略中使用标签来帮助控制谁可以查看您的资源并与之交互。有关基于标签的访问策略示例，请参阅[使用标签控制对 AWS CodeConnections 资源的访问权限](connections-tag-based-access-control.md)。
**Topics**
+ [标记资源（控制台）](#connections-tag-console)
+ [标签资源 (CLI)](#connections-tag-cli)
## 标记资源（控制台）
您可以使用控制台添加、更新或删除连接资源上的标签。
**Topics**
+ [为连接资源添加标签（控制台）](#connections-tag-console-add)
+ [查看连接资源的标签（控制台）](#connections-tag-console-view)
+ [编辑连接资源的标签（控制台）](#connections-tag-console-edit)
+ [从连接资源中删除标签（控制台）](#connections-tag-console-remove)
### 为连接资源添加标签（控制台）
您可以使用控制台向现有连接或主机添加标签。
**注意**
当您为已安装的提供商（例如 En GitHub terprise Server）创建连接并且还为您创建主机资源时，创建期间的标签只会添加到连接中。如果要将主机重用于新连接，则可以单独标记主机。如果您要将标签添加到主机，请使用此处的步骤。
****为连接添加标签****
1. 登录到控制台。从导航窗格中，选择**设置**。
1. 在 **Settings (设置)** 下，选择 **Connections (连接)**。选择**连接**选项卡。
1. 选择要编辑的连接。此时将显示连接设置页面。
1. 在 **Connection tags (连接标记)** 下，选择 **Edit (编辑)**。**Edit Connection tags (编辑连接标签)** 页面随即显示。
1. 在**键**和**值**字段中，输入您要添加的每组标签的键/值对。（**值**字段为可选项。） 例如，在**键**中，输入 **Project**。在**值**中，输入 **ProjectA**。
![\[Connection tags interface with fields for Key and Value, and buttons to Add tag and Remove tag.\]](http://docs.aws.amazon.com/zh_cn/dtconsole/latest/userguide/images/connections-tags.png)
1. （可选）选择**添加标签**以添加多行并输入多个标签。
1. 选择 **Submit (提交)**。标签在连接设置下列出。
****为主机添加标签****
1. 登录到控制台。从导航窗格中，选择**设置**。
1. 在 **Settings (设置)** 下，选择 **Connections (连接)**。选择 **Host (主机)** 选项卡。
1. 选择要编辑的主机。此时将显示主机设置页面。
1. 在 **Host tags (主机标签)** 下，选择 **Edit (编辑)**。**Host tags (主机标签)** 页面随即显示。
1. 在**键**和**值**字段中，输入您要添加的每组标签的键/值对。（**值**字段为可选项。） 例如，在**键**中，输入 **Project**。在**值**中，输入 **ProjectA**。
![\[Edit Host tags interface with fields for Key and Value, and buttons to Add tag and Remove tag.\]](http://docs.aws.amazon.com/zh_cn/dtconsole/latest/userguide/images/hosts-tag.png)
1. （可选）选择 **Add tag (添加标签)** 以添加多行并为主机输入多个标签。
1. 选择**提交**。标签在主机设置下列出。
### 查看连接资源的标签（控制台）
您可以使用控制台查看现有资源的标签。
**要查看连接的标签**
1. 登录到控制台。从导航窗格中，选择**设置**。
1. 在 **Settings (设置)** 下，选择 **Connections (连接)**。选择**连接**选项卡。
1. 选择要查看的连接。此时将显示连接设置页面。
1. 在 **Connection tags (连接标签)** 下，在 **Key (键)** 和 **Value (值)** 列下查看连接的标签。
**查看主机的标签**
1. 登录到控制台。从导航窗格中，选择**设置**。
1. 在 **Settings (设置)** 下，选择 **Connections (连接)**。选择 **Host (主机)** 选项卡。
1. 选择要查看的主机。
1. 在 **Host tags (主机标签)** 下，在 **Key (键)** 和 **Value (值)** 列下查看主机的标签。
### 编辑连接资源的标签（控制台）
您可以使用控制台来编辑已添加到连接资源的标签。
**编辑连接的标签**
1. 登录到控制台。从导航窗格中，选择**设置**。
1. 在 **Settings (设置)** 下，选择 **Connections (连接)**。选择**连接**选项卡。
1. 选择要编辑的连接。此时将显示连接设置页面。
1. 在 **Connection tags (连接标记)** 下，选择 **Edit (编辑)**。**Connection tags (连接标记)** 页面随即显示。
1. 在**键**和**值**字段中，根据需要更新每个字段的值。例如，对于 **Project** 键，在**值**中，将 **ProjectA** 更改为 **ProjectB**。
1. 选择 **Submit (提交)**。
**编辑主机的标签**
1. 登录到控制台。从导航窗格中，选择**设置**。
1. 在 **Settings (设置)** 下，选择 **Connections (连接)**。选择 **Host (主机)** 选项卡。
1. 选择要编辑的主机。此时将显示主机设置页面。
1. 在 **Host tags (主机标签)** 下，选择 **Edit (编辑)**。**Host tags (主机标签)** 页面随即显示。
1. 在**键**和**值**字段中，根据需要更新每个字段的值。例如，对于 **Project** 键，在**值**中，将 **ProjectA** 更改为 **ProjectB**。
1. 选择 **Submit (提交)**。
### 从连接资源中删除标签（控制台）
您可以使用控制台从连接资源中删除标签。当您移除关联资源的标签时，对应标签会被删除。
**删除连接的标签**
1. 登录到控制台。从导航窗格中，选择**设置**。
1. 在 **Settings (设置)** 下，选择 **Connections (连接)**。选择**连接**选项卡。
1. 选择要编辑的连接。此时将显示连接设置页面。
1. 在 **Connection tags (连接标记)** 下，选择 **Edit (编辑)**。**Connection tags (连接标记)** 页面随即显示。
1. 接下来，对于您要删除的每个标签的键和值，选择**删除标签**。
1. 选择**提交**。
**删除主机的标签**
1. 登录到控制台。从导航窗格中，选择**设置**。
1. 在 **Settings (设置)** 下，选择 **Connections (连接)**。选择 **Host (主机)** 选项卡。
1. 选择要编辑的主机。此时将显示主机设置页面。
1. 在 **Host tags (主机标签)** 下，选择 **Edit (编辑)**。**Host tags (主机标签)** 页面随即显示。
1. 接下来，对于您要删除的每个标签的键和值，选择**删除标签**。
1. 选择**提交**。
## 标签资源 (CLI)
您可以使用 CLI 在连接资源上查看、添加、更新或删除标签。
**Topics**
+ [向连接资源添加标签 (CLI)](#connections-tag-add)
+ [查看连接资源的标签 (CLI)](#connections-tag-view)
+ [编辑连接资源的标签 (CLI)](#connections-tag-edit)
+ [从连接资源中删除标签 (CLI)](#connections-tag-delete)
### 向连接资源添加标签 (CLI)
您可以使用 AWS CLI 来标记连接中的资源。
在终端或命令行运行 **tag-resource** 命令，指定要为其添加标签的资源的 Amazon 资源名称 (ARN)，以及要添加的标签的键和值。您可以添加多个标签。
****为连接添加标签****
1. 为您的资源获取 ARN。使用显示在 [列出连接](connections-list.md) 的 **list-connections** 命令来获取连接 ARN。
1. 在终端或命令行中，运行 **tag-resource** 命令。
例如，使用以下命令来标记带有两个标签的连接，一个标签键以标签值命名 *Project**ProjectA*，一个标签键名为*ReadOnly*的标签值为*true*。
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true
```
如果成功，该命令不返回任何内容。
****为主机添加标签****
1. 为您的资源获取 ARN。使用显示在 [列出主机](connections-host-list.md) 的 **list-hosts** 命令来获取主机 ARN。
1. 在终端或命令行中，运行 **tag-resource** 命令。
例如，使用以下命令使用两个标签来标记主机，一个标签键*Project*以标签值命名*ProjectA*，一个标签键名为*IscontainerBased*的标签值为*true*。
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605 --tags Key=Project,Value=ProjectA Key=IscontainerBased,Value=true
```
如果成功，该命令不返回任何内容。
### 查看连接资源的标签 (CLI)
您可以使用 AWS CLI 来查看连接资源的 AWS 标签。如果尚未添加标签，则返回的列表为空。使用 **list-tags-for-resource** 命令查看已添加到连接或主机的标签。
****查看连接的标签****
1. 为您的资源获取 ARN。使用显示在 [列出连接](connections-list.md) 的 **list-connections** 命令来获取连接 ARN。
1. 在终端或命令行中，运行 **list-tags-for-resource** 命令。例如，使用以下命令可查看连接的标签键和标签值列表。
```
aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f
```
此命令返回与资源关联的标签。此示例显示了为连接返回的两个“键-值”对。
```
{
"Tags": [
{
"Key": "Project",
"Value": "ProjectA"
},
{
"Key": "ReadOnly",
"Value": "true"
}
]
}
```
****查看主机的标签****
1. 为您的资源获取 ARN。使用显示在 [列出主机](connections-host-list.md) 的 **list-hosts** 命令来获取主机 ARN。
1. 在终端或命令行中，运行 **list-tags-for-resource** 命令。例如，使用以下命令可查看主机的标签键和标签值列表。
```
aws codestar-connections list-tags-for-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605
```
此命令返回与资源关联的标签。此示例显示了为主机返回的两个“键-值”对。
```
{
"Tags": [
{
"Key": "IscontainerBased",
"Value": "true"
},
{
"Key": "Project",
"Value": "ProjectA"
}
]
}
```
### 编辑连接资源的标签 (CLI)
您可以使用 AWS CLI 来编辑资源的标签。您可以更改现有键的值或添加另一个键。
在终端或命令行运行 **tag-resource** 命令，指定要为其更新标签的资源的 ARN，并指定要更新的标签键和标签值。
编辑标签时，任何未指定的标签键都将被保留，而具有相同键和新值的任何标签键都将被更新。通过编辑命令添加的新键将作为新的键-值对添加。
****编辑连接的标签****
1. 为您的资源获取 ARN。使用显示在 [列出连接](connections-list.md) 的 **list-connections** 命令来获取连接 ARN。
1. 在终端或命令行中，运行 **tag-resource** 命令。
在此示例中，键 `Project` 的值将更改为 `ProjectB`。
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tags Key=Project,Value=ProjectB
```
如果成功，该命令不返回任何内容。要验证与连接关联的标签，请运行 **list-tags-for-resource** 命令。
****编辑主机的标签****
1. 为您的资源获取 ARN。使用显示在 [列出主机](connections-host-list.md) 的 **list-hosts** 命令来获取主机 ARN。
1. 在终端或命令行中，运行 **tag-resource** 命令。
在此示例中，键 `Project` 的值将更改为 `ProjectB`。
```
aws codestar-connections tag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605 --tags Key=Project,Value=ProjectB
```
如果成功，该命令不返回任何内容。要验证与主机关联的标签，请运行 **list-tags-for-resource** 命令。
### 从连接资源中删除标签 (CLI)
按照以下步骤使用 AWS CLI 从资源中移除标签。当您移除关联资源的标签时，对应标签会被删除。
**注意**
如果删除连接资源，则会从删除的资源中删除所有标签关联。在删除连接资源之前，无需删除标签。
在终端或命令行运行 **untag-resource** 命令，指定要从中删除标签的资源的 ARN 以及要删除的标签的标签键。例如，要使用标签键*Project*和删除连接上的多个标签*ReadOnly*，请使用以下命令。
```
aws codestar-connections untag-resource --resource-arn arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f --tag-keys Project ReadOnly
```
如果成功，该命令不返回任何内容。要验证与资源关联的标签，请运行 **list-tags-for-resource** 命令。输出将显示所有已删除的标签。
```
{
"Tags": []
}
```