本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 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 Resource Name (ARN)，以及您要新增之標籤的索引鍵和值。

**注意**  
若要取得網域的 ARN，請執行 `describe-domain`命令：  

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

您可以將多個標籤新增至網域。例如，若要使用兩個標籤標記名為 *my\$1domain* 的網域、標籤值為 value*1 的標籤鍵名為 key*1，以及標籤值為 value2 的標籤鍵名為 *key*2： ** **

```
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 Resource Name (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
```

例如，若要使用標籤索引鍵 *key1* 和 *key2* 移除名為 *mydomain* 之網域上的多個標籤：

```
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：//[https://console.aws.amazon.com/codesuite/codeartifact/home](https://console.aws.amazon.com/codesuite/codeartifact/home) 的 AWS CodeArtifact 主控台。

1. 在**網域**頁面上，選擇要新增標籤的網域。

1. 展開**詳細資訊**區段。

1. 在**網域標籤**下，如果網域上沒有標籤，請選擇**新增**網域標籤，或者如果有，請選擇**檢視和編輯網域標籤**。

1. 選擇 **Add new tag (新增標籤)**。

1. 在**金鑰**和**值**欄位中，輸入您要新增的每個標籤的文字。(**Value (值)** 欄為選用。) 例如，在 **Key (索引鍵)** 中輸入 **Name**。在 **Value (值)** 中輸入 **Test**。  
![\[網域組態。\]](http://docs.aws.amazon.com/zh_tw/codeartifact/latest/ug/images/domain-add-tag-console.png)

1. (選用) 選擇 **Add tag (新增標籤)**，新增更多列，然後輸入更多標籤。

1. 選擇**更新網域**。

### 檢視網域的標籤 （主控台）
<a name="list-tag-domains-console"></a>

您可以使用 主控台列出現有網域的標籤。

1. 開啟位於 https：//[https://console.aws.amazon.com/codesuite/codeartifact/home](https://console.aws.amazon.com/codesuite/codeartifact/home) 的 AWS CodeArtifact 主控台。

1. 在**網域**頁面上，選擇您要檢視標籤的網域。

1. 展開**詳細資訊**區段。

1. 在**網域標籤**下，選擇**檢視和編輯網域標籤**。
**注意**  
如果沒有標籤新增至此網域，主控台會讀取**新增網域標籤**。

### 編輯網域的標籤 （主控台）
<a name="update-tag-domains-console"></a>

您可以使用 主控台來編輯已新增至網域的標籤。

1. 開啟位於 https：//[https://console.aws.amazon.com/codesuite/codeartifact/home](https://console.aws.amazon.com/codesuite/codeartifact/home) 的 AWS CodeArtifact 主控台。

1. 在**網域**頁面上，選擇您要更新標籤的網域。

1. 展開**詳細資訊**區段。

1. 在**網域標籤**下，選擇**檢視和編輯網域標籤**。
**注意**  
如果沒有標籤新增至此網域，主控台會讀取**新增網域標籤**。

1. 在 **Key (金鑰)** 和 **Value (加值)** 欄，視需要更新每個欄位的值。例如，針對 **Name** 索引鍵，在 **Value (值)** 中將 **Test** 變為 **Prod**。

1. 選擇**更新網域**。

### 從網域移除標籤 （主控台）
<a name="delete-tag-domains-console"></a>

您可以使用 主控台從網域刪除標籤。

1. 開啟位於 https：//[https://console.aws.amazon.com/codesuite/codeartifact/home](https://console.aws.amazon.com/codesuite/codeartifact/home) 的 AWS CodeArtifact 主控台。

1. 在**網域**頁面上，選擇您要移除標籤的網域。

1. 展開**詳細資訊**區段。

1. 在**網域標籤**下，選擇**檢視和編輯網域標籤**。
**注意**  
如果沒有標籤新增至此網域，主控台會讀取**新增網域標籤**。

1. 在要刪除的每個標籤的索引鍵和值旁邊，選擇**移除**。

1. 選擇**更新網域**。