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

# 在 CodeArtifact 中標記套件群組
<a name="package-group-tags"></a>

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

您可以在建立套件群組時，使用 CLI 指定標籤，或新增、移除或更新現有套件群組的標籤值。

## 標籤套件群組 (CLI)
<a name="package-group-tags-cli"></a>

您可以使用 CLI 來管理套件群組標籤。

如果您尚未設定 ， AWS CLI 請依照中的步驟進行設定[使用 AWS CodeArtifact 設定](get-set-up-for-codeartifact.md)。

**提示**  
若要新增標籤，您必須提供套件群組的 Amazon Resource Name (ARN)。若要取得套件群組的 ARN，請執行 `describe-package-group`命令：  

```
aws codeartifact describe-package-group \
   --domain {{my_domain}} \
   --package-group {{/npm/scope/anycompany~}} \
   --query packageGroup.arn
```

**Topics**
+ [將標籤新增至套件群組 (CLI)](#package-group-tags-add-cli)
+ [檢視套件群組的標籤 (CLI)](#package-group-tags-list-cli)
+ [編輯套件群組的標籤 (CLI)](#package-group-tags-edit-cli)
+ [從套件群組移除標籤 (CLI)](#package-group-tags-delete-cli)

### 將標籤新增至套件群組 (CLI)
<a name="package-group-tags-add-cli"></a>

您可以在套件群組建立時，將標籤新增至套件群組，或將標籤新增至現有的套件群組。如需有關在建立標籤時將標籤新增至套件群組的資訊，請參閱 [建立套件群組](create-package-group.md)。

若要使用 將標籤新增至現有的套件群組 AWS CLI，請在終端機或命令列執行 **tag-resource**命令，指定您要新增標籤的套件群組的 Amazon Resource Name (ARN)，以及您要新增標籤的索引鍵和值。如需套件群組 ARNs 的詳細資訊，請參閱 [套件群組 ARNs](auth-and-access-control-permissions-reference.md#package-group-arns)。

您可以將多個標籤新增至套件群組。例如，若要標記套件群組，{{/npm/scope/anycompany\~}} 有兩個標籤、一個標籤索引鍵名為 {{key1}} 且標籤值為 {{value1}}，以及一個標籤索引鍵名為 {{key2}} 且標籤值為 {{value2}}：

```
aws codeartifact tag-resource \
   --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}} \
   --tags key={{key1}},value={{value1}} key={{key2}},value={{value2}}
```

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

### 檢視套件群組的標籤 (CLI)
<a name="package-group-tags-list-cli"></a>

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

在終端機或命令列，使用套件群組的 Amazon Resource Name (ARN) 執行 **list-tags-for-resource**命令。如需套件群組 ARNs 的詳細資訊，請參閱 [套件群組 ARNs](auth-and-access-control-permissions-reference.md#package-group-arns)。

例如，若要檢視套件群組的標籤索引鍵和標籤值清單，請命名為 {{/npm/scope/anycompany\~}}，其 ARN 值為 `arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}}`

```
aws codeartifact list-tags-for-resource \
   --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}}
```

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

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

### 編輯套件群組的標籤 (CLI)
<a name="package-group-tags-edit-cli"></a>

請依照下列步驟使用 AWS CLI 編輯套件群組的標籤。您可以變更現有索引鍵的值或新增其他索引鍵。您也可以從套件群組移除標籤，如下一節所示。

在終端機或命令列，執行 **tag-resource**命令，指定您要更新標籤的套件群組 ARN，並指定標籤索引鍵和標籤值。如需套件群組 ARNs 的詳細資訊，請參閱 [套件群組 ARNs](auth-and-access-control-permissions-reference.md#package-group-arns)。

```
aws codeartifact tag-resource \
   --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}} \
   --tags key={{key1}},value={{newvalue1}}
```

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

### 從套件群組移除標籤 (CLI)
<a name="package-group-tags-delete-cli"></a>

請依照下列步驟，使用 從套件群組 AWS CLI 移除標籤。

**注意**  
如果您刪除套件群組，所有標籤關聯都會從已刪除的套件群組中移除。刪除套件群組之前，您不需要移除標籤。

在終端機或命令列，執行 **untag-resource**命令，指定您要移除標籤的套件群組 ARN，以及您要移除之標籤的標籤索引鍵。如需套件群組 ARNs的相關資訊，請參閱 [套件群組 ARNs](auth-and-access-control-permissions-reference.md#package-group-arns)。

例如，若要使用標籤索引鍵 {{key1}} 和 {{key2}} 移除套件群組上的多個標籤，{{/npm/scope/anycompany\~}}：

```
aws codeartifact untag-resource \
   --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}} \
   --tag-keys {{key1}} {{key2}}
```

如果成功，此命令沒有輸出。移除標籤後，您可以使用 `list-tags-for-resource`命令檢視套件群組上的其餘標籤。