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

# 在 CodeArtifact 中標記儲存庫
<a name="tag-repositories"></a>

標籤是與 AWS 資源關聯的索引鍵/值組。您可以在 CodeArtifact 中將標籤套用至儲存庫。如需 CodeArtifact 資源標記、使用案例、標籤索引鍵和值限制，以及支援的資源類型的詳細資訊，請參閱 [標記 資源](tag-resources.md)。

您可以在建立儲存庫時使用 CLI 來指定標籤。您可以使用 主控台或 CLI 來新增或移除標籤，並更新儲存庫中標籤的值。每個儲存庫最多可新增 50 個標籤。

**Topics**
+ [標籤儲存庫 (CLI)](#tag-repositories-tag-cli)
+ [標籤儲存庫 （主控台）](#tag-repositories-console)

## 標籤儲存庫 (CLI)
<a name="tag-repositories-tag-cli"></a>

您可以使用 CLI 來管理儲存庫標籤。

**Topics**
+ [將標籤新增至儲存庫 (CLI)](#add-repositories-tag-cli)
+ [檢視儲存庫的標籤 (CLI)](#list-repositories-tag-cli)
+ [編輯儲存庫的標籤 (CLI)](#update-repositories-tag-cli)
+ [從儲存庫移除標籤 (CLI)](#delete-repositories-tag-cli)

### 將標籤新增至儲存庫 (CLI)
<a name="add-repositories-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-repository`命令：  

```
aws codeartifact describe-repository --domain {{my_domain}} --repository {{my_repo}} --query repository.arn
```

您可以新增多個標籤到儲存庫。例如，若要在名為 {{my\_domain 的網域中為名為 my\_repo}} 的儲存庫加上兩個標籤、標籤鍵名為 {{key1}} 且標籤值為 {{value1}}，以及標籤鍵名為 {{key2}} 且標籤值為 {{value2}}： {{}}

```
aws codeartifact tag-resource --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{111122223333}}:repository/{{my_domain}}/{{my_repo}} --tags key={{key1}},value={{value1}} key={{key2}},value={{value2}}
```

如果成功，此命令沒有輸出。

### 檢視儲存庫的標籤 (CLI)
<a name="list-repositories-tag-cli"></a>

請依照下列步驟使用 AWS CLI 來檢視儲存庫的 AWS 標籤。若未新增標籤，傳回的清單空白。

在終端機或命令列上執行 **list-tags-for-resource** 命令。

**注意**  
若要取得儲存庫的 ARN，請執行 `describe-repository`命令：  

```
aws codeartifact describe-repository --domain {{my_domain}} --repository {{my_repo}} --query repository.arn
```

例如，若要在名為 {{my\_domain 且具有 ARN 值的網域中，檢視名為 my\_repo}} 之儲存庫的標籤索引鍵和標籤值清單： {{}} `arn:aws:codeartifact:{{us-west-2}}:{{111122223333}}:repository/{{my_domain}}/{{my_repo}}`

```
aws codeartifact list-tags-for-resource --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{111122223333}}:repository/{{my_domain}}/{{my_repo}}
```

若成功，此命令會傳回類似如下的資訊：

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

### 編輯儲存庫的標籤 (CLI)
<a name="update-repositories-tag-cli"></a>

請依照下列步驟，使用 AWS CLI 編輯儲存庫的標籤。您可以變更現有索引鍵的值或新增其他索引鍵。

在終端機或命令列，執行 **tag-resource**命令，指定您要更新標籤的儲存庫 ARN，並指定標籤索引鍵和標籤值。

**注意**  
若要取得儲存庫的 ARN，請執行 `describe-repository`命令：  

```
aws codeartifact describe-repository --domain {{my_domain}} --repository {{my_repo}} --query repository.arn
```

```
aws codeartifact tag-resource --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{111122223333}}:repository/{{my_domain}}/{{my_repo}} --tags key={{key1}},value={{newvalue1}}
```

如果成功，此命令沒有輸出。

### 從儲存庫移除標籤 (CLI)
<a name="delete-repositories-tag-cli"></a>

請依照下列步驟，使用 從儲存庫 AWS CLI 移除標籤。

**注意**  
如果您刪除 儲存庫，所有標籤關聯會從已刪除的儲存庫中移除。您不需要在刪除儲存庫之前移除標籤。

在終端機或命令列，執行 **untag-resource**命令，指定您要移除標籤之儲存庫的 ARN，以及您要移除之標籤的標籤索引鍵。

**注意**  
若要取得儲存庫的 ARN，請執行 `describe-repository`命令：  

```
aws codeartifact describe-repository --domain {{my_domain}} --repository {{my_repo}} --query repository.arn
```

例如，若要在名為 {{my\_domain 的網域中，使用標籤索引鍵 key1 和 key2 移除名為 my\_repo}} 的儲存庫上的多個標籤： {{}} {{}} {{}}

```
aws codeartifact untag-resource --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{111122223333}}:repository/{{my_domain}}/{{my_repo}} --tag-keys {{key1}} {{key2}}
```

如果成功，此命令沒有輸出。移除標籤後，您可以使用 `list-tags-for-resource`命令檢視儲存庫上剩餘的標籤。

## 標籤儲存庫 （主控台）
<a name="tag-repositories-console"></a>

您可以使用主控台或 CLI 以標記資源。

**Topics**
+ [將標籤新增至儲存庫 （主控台）](#add-tag-repositories-console)
+ [檢視儲存庫的標籤 （主控台）](#list-tag-repositories-console)
+ [編輯儲存庫的標籤 （主控台）](#update-tag-repositories-console)
+ [從儲存庫移除標籤 （主控台）](#delete-tag-repositories-console)

### 將標籤新增至儲存庫 （主控台）
<a name="add-tag-repositories-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/repo-add-tag-console.png)

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

1. 選擇**更新儲存庫**。

### 檢視儲存庫的標籤 （主控台）
<a name="list-tag-repositories-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-repositories-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-repositories-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. 選擇**更新儲存庫**。