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

# 在 中標記儲存庫 AWS CodeCommit
<a name="how-to-tag-repository"></a>

*標籤*是您或 AWS 指派給 AWS resource. AWS tags 的自訂屬性標籤，與可套用至遞交的 Git 標籤不同。每個 AWS 標籤有兩個部分：
+ *標籤鍵* (例如，`CostCenter`、`Environment`、`Project` 或 `Secret` )。標籤鍵會區分大小寫。
+ 一個名為*標籤值* (例如，`111122223333`、`Production` 或團隊名稱) 的選用欄位。忽略標籤值基本上等同於使用空字串。與標籤鍵相同，標籤值會區分大小寫。

這些合稱為鍵值組。對於儲存庫上標籤數量的限制以及標籤金鑰和值的限制，請參閱 [限制](limits.md#limits-tags)。

標籤可協助您識別和組織 AWS 資源。許多 AWS 服務支援標記，因此您可以將相同的標籤指派給來自不同 服務的資源，以指出資源相關。例如，您可以將相同的標籤指派給指派給 Amazon S3 儲存貯體的 CodeCommit 儲存庫。如需標記策略的詳細資訊，請參閱[標記 AWS 資源](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)。

在 CodeCommit 中，主要資源是儲存庫。您可以使用 CodeCommit 主控台、 AWS CLI、CodeCommit APIs或 AWS SDKs 來新增、管理和移除儲存庫的標籤。除了識別、組織和追蹤具有標籤的儲存庫之外，您還可以在 IAM 政策中使用標籤，以協助控制誰可以檢視儲存庫並與之互動。如需以標籤為基礎的存取政策範例，請參閱[範例 5：在具有標籤的儲存庫上拒絕或允許動作](customer-managed-policies.md#identity-based-policies-example-5)。

**Topics**
+ [新增標籤至儲存庫](how-to-tag-repository-add.md)
+ [檢視儲存庫的標籤](how-to-tag-repository-list.md)
+ [檢視儲存庫的標籤](how-to-tag-repository-update.md)
+ [從儲存庫移除標籤](how-to-tag-repository-delete.md)

# 新增標籤至儲存庫
<a name="how-to-tag-repository-add"></a>

將標籤新增至儲存庫可協助您識別和組織 AWS 資源，並管理對資源的存取。首先，您將一或多個標籤 (金鑰值組) 到儲存庫。請記住儲存庫的標籤數有所限制。金鑰和值欄位可使用的字數有所限制。如需詳細資訊，請參閱[限制](limits.md#limits-tags)。擁有標籤後，您可以建立 IAM 政策，根據這些標籤管理對儲存庫的存取。您可以使用 CodeCommit 主控台或 AWS CLI 將標籤新增至儲存庫。

**重要**  
新增標籤到儲存庫可能會影響存取該儲存庫。將標籤新增至儲存庫之前，請務必檢閱任何可能使用標籤來控制存取儲存庫等資源的 IAM 政策。如需以標籤為基礎的存取政策範例，請參閱[範例 5：在具有標籤的儲存庫上拒絕或允許動作](customer-managed-policies.md#identity-based-policies-example-5)。

當您建立時，如需有關將標籤新增到儲存庫的詳細資訊，請參閱 [建立儲存庫 （主控台）](how-to-create-repository.md#how-to-create-repository-console)。

**Topics**
+ [將標籤新增至儲存庫 （主控台）](#how-to-tag-repository-add-console)
+ [將標籤新增至儲存庫 (AWS CLI)](#how-to-tag-repository-add-cli)

## 將標籤新增至儲存庫 （主控台）
<a name="how-to-tag-repository-add-console"></a>

您可以使用 CodeCommit 主控台，將一或多個標籤新增至 CodeCommit 儲存庫。

1. 在 https：//[https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home) 開啟 CodeCommit 主控台。

1. 在 **Repositories (儲存庫)** 中，選擇您要新增標籤所在的儲存庫名稱。

1. 在導覽窗格中，選擇**設定**。選擇 **Repository tags (儲存庫標籤)**。

1. 如果沒有已經新增到儲存庫的標籤，請選擇 **Add tag (新增標籤)**。否則，選擇 **Edit (編輯)**，然後選擇 **Add tag (新增標籤)**。

1. 在 **Key (金鑰)** 中，輸入標籤的名稱。您可以在 **Value (值)** 中為標籤新增選用值。  
![\[新增標籤至儲存庫\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-repository-tags-edit.png)

1. (選用) 若要新增另一個標籤，再選擇 **Add tag (新增標籤)** 一次。

1. 當您完成新增標籤的作業時，請選擇 **Submit (提交)**。

## 將標籤新增至儲存庫 (AWS CLI)
<a name="how-to-tag-repository-add-cli"></a>

請依照下列步驟，使用 AWS CLI 將標籤新增至 CodeCommit 儲存庫。若要在建立儲存庫將標籤新增到儲存庫，請參閱[建立儲存庫 (AWS CLI)](how-to-create-repository.md#how-to-create-repository-cli)。

在這些步驟中，我們假設您已經安裝新版 AWS CLI 或更新到最新版本。如需詳細資訊，請參閱[安裝 AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)。

在終端機或命令列，執行 **tag-resource** 命令，指定您要新增標籤之儲存庫的 Amazon Resource Name (ARN)，和您想新增之標籤的索引鍵和值。您可以新增多個標籤到儲存庫。例如，若要使用兩個標籤標記名為 *MyDemoRepo* 的儲存庫、使用標籤值為 *Secret* 的名為 *Status* 的標籤金鑰，以及使用標籤值為 *Saanvi* 的名為 *Team* 的標籤金鑰：

```
aws codecommit tag-resource --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo --tags Status=Secret,Team=Saanvi 
```

若成功，此命令不會傳回任何內容。

# 檢視儲存庫的標籤
<a name="how-to-tag-repository-list"></a>

標籤可協助您識別和組織 AWS 資源，並管理對資源的存取。如需標記策略的詳細資訊，請參閱[標記 AWS 資源](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)。如需以標籤為基礎的存取政策範例，請參閱[範例 5：在具有標籤的儲存庫上拒絕或允許動作](customer-managed-policies.md#identity-based-policies-example-5)。

## 檢視儲存庫的標籤 （主控台）
<a name="how-to-tag-repository-list-console"></a>

您可以使用 CodeCommit 主控台來檢視與 CodeCommit 儲存庫相關聯的標籤。

1. 在 https：//[https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home) 開啟 CodeCommit 主控台。

1. 在 **Repositories (儲存庫)** 中，選擇您要檢視標籤所在的儲存庫名稱。

1. 在導覽窗格中，選擇**設定**。選擇 **Repository tags (儲存庫標籤)**。  
![\[檢視儲存庫的標籤\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-repository-tags-view.png)

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

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

在終端機或命令列上執行 **list-tags-for-resource** 命令。例如，若要使用 ARN arn：aws：codecommit：us-east-2：：*MyDemoRepo* 之儲存庫的標籤索引鍵和標籤值清單： *111111111111 MyDemoRepo*

```
aws codecommit list-tags-for-resource --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo
```

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

```
{
    "tags": {
        "Status": "Secret",
        "Team": "Saanvi"
    }
}
```

# 檢視儲存庫的標籤
<a name="how-to-tag-repository-update"></a>

您可以變更與儲存庫相關聯標籤的值。您也可以變更金鑰的名稱，這相當於移除目前的標籤，並新增具有新名稱和與其他金鑰相同值的不同標籤。請記住金鑰和值欄位可使用的字數有所限制。如需詳細資訊，請參閱[限制](limits.md#limits-tags)。

**重要**  
編輯儲存庫標籤可能會影響存取該儲存庫。在編輯儲存庫標籤的名稱 （索引鍵） 或值之前，請務必檢閱任何可能使用標籤索引鍵或值的 IAM 政策，以控制儲存庫等資源的存取。如需以標籤為基礎的存取政策範例，請參閱[範例 5：在具有標籤的儲存庫上拒絕或允許動作](customer-managed-policies.md#identity-based-policies-example-5)。

## 編輯儲存庫的標籤 （主控台）
<a name="how-to-tag-repository-update-console"></a>

您可以使用 CodeCommit 主控台來編輯與 CodeCommit 儲存庫相關聯的標籤。

1. 在 https：//[https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home) 開啟 CodeCommit 主控台。

1. 在 **Repositories (儲存庫)** 中，選擇您要編輯標籤所在的儲存庫名稱。

1. 在導覽窗格中，選擇**設定**。選擇 **Repository tags (儲存庫標籤)**。

1. 選擇**編輯**。

1.   
![\[編輯儲存庫的標籤值\]](http://docs.aws.amazon.com/zh_tw/codecommit/latest/userguide/images/codecommit-repository-tags-edit2.png)

   執行以下任意一項：
   + 若要變更標籤，請在 **Key (金鑰)** 輸入新的名稱。變更標籤名稱等於移除標籤並使用新的金鑰名稱新增一個新的標籤。
   + 若要變更標籤的值，請輸入新的值。如果您想要變更值為沒有，請刪除目前的值並保留欄位空白。

1. 當您完成編輯標籤，選擇 **Submit (提交)**。

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

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

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

```
aws codecommit tag-resource --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo --tags Team=Li
```

# 從儲存庫移除標籤
<a name="how-to-tag-repository-delete"></a>

您可以移除一或多個儲存庫關聯的標籤。移除標籤不會從與該標籤相關聯的其他 AWS 資源中刪除標籤。

**重要**  
移除儲存庫標籤可能會影響存取該儲存庫。從儲存庫移除標籤之前，請務必檢閱任何可能使用標籤金鑰或值的 IAM 政策，以控制儲存庫等資源的存取。如需以標籤為基礎的存取政策範例，請參閱[範例 5：在具有標籤的儲存庫上拒絕或允許動作](customer-managed-policies.md#identity-based-policies-example-5)。

## 從儲存庫移除標籤 （主控台）
<a name="how-to-tag-repository-delete-console"></a>

您可以使用 CodeCommit 主控台來移除標籤與 CodeCommit 儲存庫之間的關聯。

1. 在 https：//[https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home) 開啟 CodeCommit 主控台。

1. 在 **Repositories (儲存庫)** 中，選擇您要移除標籤所在的儲存庫名稱。

1. 在導覽窗格中，選擇**設定**。選擇 **Repository tags (儲存庫標籤)**。

1. 選擇**編輯**。

1. 尋找您想要移除的標籤，然後選擇 **Remove tag (移除標籤)**。

1. 當您完成移除標籤，請選擇 **Submit (提交)**。

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

請依照下列步驟，使用 從 CodeCommit 儲存庫 AWS CLI 移除標籤。移除標籤並不會將其刪除，只會移除標籤和儲存庫之間的關聯性。

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

在終端機或命令列，執行 **untag-resource** 命令，指定您要移除標籤之儲存庫的 Amazon Resource Name (ARN)，和您想移除之標籤的標籤索引鍵。例如，若要在名為 *MyDemoRepo* 的儲存庫上移除具有標籤索引鍵*狀態*的標籤：

```
aws codecommit untag-resource --resource-arn arn:aws:codecommit:us-west-2:111111111111:MyDemoRepo --tag-keys Status
```

若成功，此命令不會傳回任何內容。若要驗證與儲存庫關聯的標籤，請執行 **list-tags-for-resource** 命令。