本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 標記連線資源
*標籤*是您或 AWS 指派給 AWS 資源的自訂屬性標籤。每個 AWS 標籤有兩個部分：
+ *標籤鍵* (例如，`CostCenter`、`Environment` 或 `Project`)。標籤金鑰會區分大小寫。
+ 一個名為*標籤值* (例如，`111122223333`、`Production` 或團隊名稱) 的選用欄位。忽略標籤值基本上等同於使用空字串。與標籤鍵相同，標籤值會區分大小寫。
這些合稱為*鍵值組*。
您可以使用主控台或 CLI 以標記資源。
您可以在 AWS CodeConnections 中標記下列資源類型：
+ 連線
+ 主機
這些步驟假設您已安裝最新版本的 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)
### 將標籤新增至連線資源 (主控台)
您可以使用主控台將標籤新增到現有連線或主機。
**注意**
當您為安裝式供應商 (例如 GitHub Enterprise Server) 建立連線，而且系統也為您建立了主機資源時，建立期間的標籤只會新增至連線。如果您想要將標籤重複用於新連線，這可讓您分別標記主機。如果您想要將標籤新增到主機，請使用這裡說明的步驟。
****為連線新增標籤****
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Connections (連線)** 索引標籤。
1. 選擇您要編輯的連線。隨即會顯示連線設定頁面。
1. 在 **Connection tags (連線標籤)** 底下，選擇 **Edit (編輯)**。隨即會顯示 **Edit Connection tags (編輯連線標籤)** 頁面。
1. 在 **Key (索引鍵)** 和Value**Value (值)** 欄中，在你想新增的各組標籤中輸入金鑰對。(**Value (值)** 欄為選用。) 例如，在 **Key (索引鍵)** 中輸入 **Project**。在 **Value (值)** 中輸入 **ProjectA**。
![\[Connection tags interface with fields for Key and Value, and buttons to Add tag and Remove tag.\]](http://docs.aws.amazon.com/zh_tw/dtconsole/latest/userguide/images/connections-tags.png)
1. (選用) 選擇 **Add tag (新增標籤)**，新增更多列，然後輸入更多標籤。
1. 選擇**提交**。標籤會列在連線設定之下。
****為主機新增標籤****
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Hosts (主機)** 索引標籤。
1. 選擇您要編輯的主機。隨即會顯示主機設定頁面。
1. 在 **Host tags(主機標籤)** 底下，選擇 **Edit (編輯)**。隨即會顯示 **Host tags (主機標籤)** 頁面。
1. 在 **Key (索引鍵)** 和Value**Value (值)** 欄中，在你想新增的各組標籤中輸入金鑰對。(**Value (值)** 欄為選用。) 例如，在 **Key (索引鍵)** 中輸入 **Project**。在 **Value (值)** 中輸入 **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_tw/dtconsole/latest/userguide/images/hosts-tag.png)
1. (選用) 選擇 **Add tag (新增標籤)**，新增更多列，然後為主機輸入更多標籤。
1. 選擇**提交**。標籤列在主機設定之下。
### 檢視連線資源的標籤 (主控台)
您可以使用主控台檢視現有資源的標籤。
**檢視連線的標籤**
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Connections (連線)** 索引標籤。
1. 選擇您要檢視的連線。隨即會顯示連線設定頁面。
1. 在 **Connection tags (連線標籤)** 底下，檢視 **Key (索引鍵)** 和 **Value (值)** 欄下方的連線標籤。
**檢視主機的標籤**
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Hosts (主機)** 索引標籤。
1. 選擇您要檢視的主機。
1. 在 **Host tags (主機標籤)** 底下，檢視 **Key (索引鍵)** 和 **Value (值)** 欄下方的主機標籤。
### 編輯連線資源的標籤 (主控台)
您可以使用主控台來編輯已新增到連線資源的標籤。
**編輯連線的標籤**
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Connections (連線)** 索引標籤。
1. 選擇您要編輯的連線。隨即會顯示連線設定頁面。
1. 在 **Connection tags (連線標籤)** 底下，選擇 **Edit (編輯)**。隨即會顯示 **Connection tags (連線標籤)** 頁面。
1. 在 **Key (金鑰)** 和 **Value (加值)** 欄，視需要更新每個欄位的值。例如，針對 **Project** 索引鍵，在 **Value (值)** 中將 **ProjectA** 變為 **ProjectB**。
1. 選擇**提交**。
**編輯主機的標籤**
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Hosts (主機)** 索引標籤。
1. 選擇您要編輯的主機。隨即會顯示主機設定頁面。
1. 在 **Host tags(主機標籤)** 底下，選擇 **Edit (編輯)**。隨即會顯示 **Host tags (主機標籤)** 頁面。
1. 在 **Key (金鑰)** 和 **Value (加值)** 欄，視需要更新每個欄位的值。例如，針對 **Project** 索引鍵，在 **Value (值)** 中將 **ProjectA** 變為 **ProjectB**。
1. 選擇**提交**。
### 移除連線資源的標籤 (主控台)
您可以使用主控台或移除連線資源的標籤。當您從關聯的資源移除標籤時，將會刪除這些標籤。
**移除連線的標籤**
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Connections (連線)** 索引標籤。
1. 選擇您要編輯的連線。隨即會顯示連線設定頁面。
1. 在 **Connection tags (連線標籤)** 底下，選擇 **Edit (編輯)**。隨即會顯示 **Connection tags (連線標籤)** 頁面。
1. 在您要刪除的金鑰和值的每個標籤旁邊，選擇 **移除標籤 (Remove tag)**。
1. 選擇**提交**。
**移除主機的標籤**
1. 登入主控台。從導覽窗格中，選擇 **Settings (設定)**。
1. 在 **Settings (設定)** 底下，選擇 **Connections (連線)**。選擇 **Hosts (主機)** 索引標籤。
1. 選擇您要編輯的主機。隨即會顯示主機設定頁面。
1. 在 **Host tags(主機標籤)** 底下，選擇 **Edit (編輯)**。隨即會顯示 **Host tags (主機標籤)** 頁面。
1. 在您要刪除的金鑰和值的每個標籤旁邊，選擇 **移除標籤 (Remove tag)**。
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 Resource Name (ARN)，以及您想新增之標籤的索引鍵和數值。您可以新增一個以上的標籤。
****為連線新增標籤****
1. 為您的資源取得 ARN。使用 [列出連線](connections-list.md) 中顯示的 **list-connections** 命令來取得連線 ARN。
1. 在終端機或命令列上執行 **tag-resource** 命令。
例如，使用下列命令來標記具有兩個標籤的連線，一個名為 *Project* 的標籤鍵且標籤值為 *Project*，以及一個名為 *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，並指定要更新的標籤索引鍵和標籤值。
編輯標籤時，任何未指定的標籤索引鍵都會保留，任何項目的索引鍵都相同，但會以新值更新。使用 edit 命令新增的索引鍵會新增為一對新的鍵值組。
****編輯連線的標籤****
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": []
}
```