As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Marcar um grupo de pacotes no CodeArtifact
As tags são pares de chave-valor associados a recursos da AWS. Você pode aplicar tags aos grupos de pacotes no CodeArtifact. Para obter informações sobre a atribuição de tags do recurso do CodeArtifact, casos de uso, restrições de chave e valor de tag, além de tipos de recursos compatíveis, consulte [Marcando atributos](tag-resources.md).
Você pode usar a CLI para especificar tags ao criar um grupo de pacotes ou adicionar, remover ou atualizar o valor das tags de um grupo de pacotes existente.
## Grupos de pacotes de tag (CLI)
É possível usar a CLI para gerenciar tags de grupos de pacotes.
Caso não tenha feito isso, configure a AWS CLI seguindo as etapas em[Configurando com AWS CodeArtifact](get-set-up-for-codeartifact.md).
**dica**
Para adicionar tags, você deve fornecer o nome do recurso da Amazon (ARN) do grupo de pacotes. Para obter o ARN do grupo de pacotes, execute o comando `describe-package-group`:
```
aws codeartifact describe-package-group \
--domain {{my_domain}} \
--package-group {{/npm/scope/anycompany~}} \
--query packageGroup.arn
```
**Topics**
+ [Adicionar tags a um grupo de pacotes (CLI)](#package-group-tags-add-cli)
+ [Exibir tags para um grupo de pacotes (CLI)](#package-group-tags-list-cli)
+ [Editar tags para um grupo de pacotes (CLI)](#package-group-tags-edit-cli)
+ [Remover tags de um grupo de pacotes (CLI)](#package-group-tags-delete-cli)
### Adicionar tags a um grupo de pacotes (CLI)
É possível adicionar tags aos grupos de pacotes quando eles são criados ou a um grupo de pacotes existente. Para obter informações sobre como adicionar tags a um grupo de pacotes ao criá-lo, consulte [Criar um grupo de pacotes](create-package-group.md).
Para adicionar uma tag a um grupo de pacotes existente com a AWS CLI, no terminal ou na linha de comando, execute o comando **tag-resource**, especificando o nome do recurso da Amazon (ARN) do grupo de pacotes ao qual você deseja adicionar tags, bem como a chave e o valor da tag que deseja adicionar. Para obter informações sobre ARNs de grupos de pacotes, consulte [Package group ARNs](auth-and-access-control-permissions-reference.md#package-group-arns).
Você pode adicionar mais de uma tag a um grupo de pacotes. Por exemplo, para marcar um grupo de pacotes, {{/npm/scope/anycompany\~}}, com duas tags, uma chave de tag chamada {{key1}} com o valor de tag de {{value1}} e uma chave de tag chamada {{key2}} com o valor de tag de {{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}}
```
Se for bem-sucedido, este comando não terá saída.
### Exibir tags para um grupo de pacotes (CLI)
Siga estas etapas para usar a AWS CLI para visualizar as tags da AWS para um grupo de pacotes. Se não foram adicionadas tags, a lista retornará vazia.
No terminal ou na linha de comando, execute o comando **list-tags-for-resource** com o nome do recurso da Amazon (ARN) do grupo de recursos. Para obter informações sobre ARNs de grupos de pacotes, consulte [Package group ARNs](auth-and-access-control-permissions-reference.md#package-group-arns).
Por exemplo, para visualizar uma lista de chaves e valores de tag para um grupo de pacotes, {{/npm/scope/anycompany\~}}, nomeado com um valor de ARN de `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~}}
```
Se houver êxito, o comando retornará informações semelhantes às seguintes:
```
{
"tags": {
"key1": "value1",
"key2": "value2"
}
}
```
### Editar tags para um grupo de pacotes (CLI)
Siga estas etapas para usar a AWS CLI para editar uma tag para um grupo de pacotes. Você pode alterar o valor para uma chave existente ou adicionar outra chave. Você também pode remover tags de um grupo de pacotes, como mostrado na próxima seção.
No terminal ou na linha de comando, execute o comando **tag-resource**, especificando o ARN do grupo de pacotes em que deseja atualizar uma tag e especifique a chave e o valor da tag. Para obter informações sobre ARNs de grupos de pacotes, consulte [Package group 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}}
```
Se for bem-sucedido, este comando não terá saída.
### Remover tags de um grupo de pacotes (CLI)
Siga estas etapas para usar a AWS CLI para remover uma tag de um grupo de pacotes.
**nota**
Se você excluir um grupo de pacotes, todas as associações de tag serão removidas do grupo de pacotes excluído. Não é necessário remover as tags antes de excluir um grupo de pacotes.
No terminal ou na linha de comando, execute o comando **untag-resource**, especificando o ARN do grupo de pacotes no qual você deseja remover tags e a chave da tag que deseja remover. Para obter informações sobre ARNs de grupos de pacotes, consulte [Package group ARNs](auth-and-access-control-permissions-reference.md#package-group-arns).
Por exemplo, para remover várias tags em um grupo de pacotes, {{/npm/scope/anycompany \~}}, com as chaves de tag {{key1}} e {{key2}}:
```
aws codeartifact untag-resource \
--resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:package-group/{{my_domain}}/{{npm/scope/anycompany~}} \
--tag-keys {{key1}} {{key2}}
```
Se for bem-sucedido, este comando não terá saída. Após remover as tags, você pode exibir as tags restantes no grupo de pacotes usando o comando `list-tags-for-resource`.