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

# 在 Amazon ECR 中標記私有儲存庫
<a name="ecr-using-tags"></a>

為了協助您管理 Amazon ECR 儲存庫，您可以使用 AWS 資源*標籤*，將自己的中繼資料指派給新的或現有的 Amazon ECR 儲存庫。例如，您可以為帳戶的 Amazon ECR 儲存庫定義一組標籤，協助您追蹤各個儲存庫的擁有者。

## 標籤基本概念
<a name="tag-basics"></a>

標籤對 Amazon ECR 來說不具有任何語意意義，並會嚴格解譯為字元字串。標籤不會自動指派給您的資源。您可以編輯標籤索引鍵和值，也可以隨時從資源中移除標籤。您可以將標籤的值設為空白字串，但您無法將標籤的值設為 Null。若您將與現有標籤具有相同鍵的標籤新增到該資源，則新值會覆寫舊值。如果您刪除資源，也會刪除任何該資源所使用的標籤。

您可以使用 Amazon ECR 主控台、 AWS CLI和 Amazon ECR API 來使用標籤。

使用 AWS Identity and Access Management (IAM)，您可以控制 AWS 帳戶中哪些使用者具有建立、編輯或刪除標籤的許可。如需 IAM 政策中標籤的資訊，請參閱 [使用標籤型存取控制](ecr-supported-iam-actions-tagging.md)。

## 標記您的資源以便計費
<a name="tag-resources-for-billing"></a>

您新增至 Amazon ECR 儲存庫的標籤在成本與用量報告中啟用後，有助於檢視成本分配。如需詳細資訊，請參閱[Amazon ECR 用量報告](usage-reports.md)。

若想要查看合併資源的成本，您可根據具有相同標籤金鑰值的資源來整理您的帳單資訊。例如，您可以使用特定應用程式名稱來標記數個資源，然後整理帳單資訊以查看該應用程式跨數項服務的總成本。如需有關使用標籤設定成本分配報告的詳細資訊，請參閱《AWS Billing 使用者指南》**中的[每月成本分配報告](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html)。

**注意**  
若您才剛啟用報告，目前月份的資料會在 24 小時之後提供檢視。

# 將標籤新增至 Amazon ECR 中的私有儲存庫
<a name="adding-tags-repositories"></a>

您可以將標籤新增至私有儲存庫。

如需標籤名稱和最佳實務的相關資訊，請參閱*《標記 AWS 資源使用者指南*》中的[標籤命名限制和要求](https://docs.aws.amazon.com//tag-editor/latest/userguide/tagging.html#tag-conventions)以及[最佳實務](https://docs.aws.amazon.com//tag-editor/latest/userguide/tagging.html#tag-best-practices)。

## 將標籤新增至儲存庫 (AWS 管理主控台)
<a name="tag-resources-console"></a>

1. 在 [https://console.aws.amazon.com/ecr/](https://console.aws.amazon.com/ecr/) 開啟 Amazon ECR 主控台。

1. 從導覽列中選取要使用的區域。

1. 在導覽窗格中，選擇 **Repositories** (儲存庫)。

1. 在**儲存庫**頁面上，選取要標記之儲存庫旁邊的核取方塊。

1. 從**動作**選單中選取**儲存庫標籤**。

1. 在**儲存庫標籤**頁面上，選取**新增標籤**、**新增標籤**。

1. 在**編輯儲存庫標籤**頁面上，指定每個標籤的索引鍵和值，然後選擇**儲存**。

## 將標籤新增至儲存庫 (AWS CLI 或 API)
<a name="tag-resources-api-sdk"></a>

您可以使用 或 AWS CLI API 新增或覆寫一或多個標籤。
+ AWS CLI - [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/ecr/tag-resource.html)
+ API 動作：[TagResource](https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_TagResource.html)

下列範例示範如何使用 新增標籤 AWS CLI。

**範例 1：標記儲存庫**  
下列命令會標記儲存庫。

```
aws ecr tag-resource \
     --resource-arn arn:aws:ecr:region:account_id:repository/repository_name \
     --tags Key=stack,Value=dev
```

**範例 2：使用多個標籤標記儲存庫**  
下列命令會將三個標籤新增至儲存庫。

```
aws ecr tag-resource \
     --resource-arn arn:aws:ecr:region:account_id:repository/repository_name \
     --tags Key=key1,Value=value1 Key=key2,Value=value2 Key=key3,Value=value3
```

**範例 3：列出儲存庫的標籤**  
下列命令會列出與儲存庫相關聯的標籤。

```
aws ecr list-tags-for-resource \
     --resource-arn arn:aws:ecr:region:account_id:repository/repository_name
```

**範例 4：建立儲存庫並新增標籤**  
以下命令建立名為 `test-repo` 的儲存庫，並新增索引鍵為 `team` 和值為 `devs` 的標籤。

```
aws ecr create-repository \
     --repository-name test-repo \
     --tags Key=team,Value=devs
```

# 從 Amazon ECR 中的私有儲存庫刪除標籤
<a name="deleting-tags-repositories"></a>

您可以從私有儲存庫刪除標籤。

## 從私有儲存庫刪除標籤 (AWS 管理主控台)
<a name="deleting-tags-repositories-console"></a>

1. 在 [https://console.aws.amazon.com/ecr/](https://console.aws.amazon.com/ecr/) 開啟 Amazon ECR 主控台。

1. 從導覽列中選取要使用的區域。

1. 在**儲存庫**頁面上，選取要移除標籤之儲存庫旁邊的核取方塊。

1. 從**動作**選單中選取**儲存庫標籤**。

1. 在**儲存庫標籤**頁面上，選取**編輯**。

1. 在**編輯儲存庫標籤**頁面上，針對您要刪除的每個標籤，選取**移除**圖示，然後選擇**儲存**。

## 從私有儲存庫刪除標籤 (AWS CLI)
<a name="deleting-tags-repositories-cli"></a>

您可以使用 或 AWS CLI API 刪除一或多個標籤。
+ AWS CLI - [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/ecr/untag-resource.html)
+ API 動作 - [UntagResource](https://docs.aws.amazon.com/AmazonECR/latest/APIReference/API_UntagResource.html)

下列範例顯示如何使用 從儲存庫刪除標籤 AWS CLI。

```
aws ecr untag-resource \
     --resource-arn arn:aws:ecr:region:account_id:repository/repository_name \
     --tag-keys tag_key
```