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 domínio em CodeArtifact
<a name="tag-domains"></a>

As tags são pares de chave-valor associados a recursos da AWS. Você pode aplicar tags aos seus domínios em CodeArtifact. Para obter informações sobre marcação de CodeArtifact recursos, casos de uso, restrições de valor e chave de tag e tipos de recursos compatíveis, consulte. [Marcando atributos](tag-resources.md)

Você pode usar a CLI para especificar tags ao criar um domínio. Você pode usar o console ou a CLI para adicionar ou remover tags e atualizar os valores das tags em um domínio. Você pode adicionar até 50 tags a cada domínio.

**Topics**
+ [Domínios de tag (CLI)](#tag-domains-tag-cli)
+ [Marcar domínios (console)](#tag-domains-console)

## Domínios de tag (CLI)
<a name="tag-domains-tag-cli"></a>

É possível usar a CLI para gerenciar tags de domínio.

**Topics**
+ [Adicionar tags a um domínio (CLI)](#add-domains-tag-cli)
+ [Exibir tags para um domínio (CLI)](#list-domains-tag-cli)
+ [Editar tags para um domínio (CLI)](#update-domains-tag-cli)
+ [Remover tags de um domínio (CLI)](#delete-domains-tag-cli)

### Adicionar tags a um domínio (CLI)
<a name="add-domains-tag-cli"></a>

Você pode usar o console ou o AWS CLI para marcar domínios.

Para adicionar uma tag a um domínio ao criá-lo, consulte [Criar um repositório](create-repo.md).

Nestas etapas, partimos do princípio de que você já instalou uma versão recente da AWS CLI ou atualizou para a versão atual. Para obter mais informações, consulte [Instalar a AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html).

No terminal ou na linha de comando, execute o comando **tag-resource**, especificando o nome do recurso da Amazon (ARN) do domínio em que você deseja adicionar tags e a chave e o valor da tag que você deseja adicionar.

**nota**  
Para obter o ARN do domínio, execute o comando `describe-domain`:  

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

Você pode adicionar mais de uma tag a um domínio. Por exemplo, para marcar um domínio chamado {{my\_domain}} com duas tags, uma chave de tag {{key1}} com o valor de tag de {{value1}} e uma chave de tag {{key2}} com o valor de tag de{{value2}}:

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

Se for bem-sucedido, este comando não terá saída.

### Exibir tags para um domínio (CLI)
<a name="list-domains-tag-cli"></a>

Siga estas etapas para usar o AWS CLI para visualizar as AWS tags de um domínio. 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 domínio.

**nota**  
Para obter o ARN do domínio, execute o comando `describe-domain`:  

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

Por exemplo, para ver uma lista de chaves e valores de tag para um domínio chamado {{my\_domain}} com o valor `arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:domain/{{my_domain}}` ARN:

```
aws codeartifact list-tags-for-resource --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:domain/{{my_domain}}
```

Se houver êxito, o comando retornará informações semelhantes às seguintes:

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

### Editar tags para um domínio (CLI)
<a name="update-domains-tag-cli"></a>

Siga estas etapas para usar o AWS CLI para editar uma tag para um domínio. Você pode alterar o valor para uma chave existente ou adicionar outra chave. Você também pode remover tags de um domínio, como mostrado na próxima seção.

No terminal ou na linha de comando, execute o comando **tag-resource**, especificando o ARN do domínio no qual deseja atualizar uma tag e especifique a chave e o valor da tag:

**nota**  
Para obter o ARN do domínio, execute o comando `describe-domain`:  

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

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

Se for bem-sucedido, este comando não terá saída.

### Remover tags de um domínio (CLI)
<a name="delete-domains-tag-cli"></a>

Siga estas etapas para usar o AWS CLI para remover uma tag de um domínio.

**nota**  
Se você excluir um domínio, todas as associações de tag serão removidas do domínio excluído. Você não precisa remover as tags antes de excluir um domínio.

No terminal ou na linha de comando, execute o comando **untag-resource**, especificando o ARN do domínio de onde você deseja remover tags e a chave da tag que deseja remover.

**nota**  
Para obter o ARN do domínio, execute o comando `describe-domain`:  

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

Por exemplo, para remover várias tags em um domínio chamado {{mydomain}} com as chaves de tag {{key1}} e{{key2}}:

```
aws codeartifact untag-resource --resource-arn arn:aws:codeartifact:{{us-west-2}}:{{123456789012}}:domain/{{my_domain}} --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 domínio usando o comando `list-tags-for-resource`.

## Marcar domínios (console)
<a name="tag-domains-console"></a>

Você pode usar o console ou a CLI para marcar recursos.

**Topics**
+ [Adicionar tags a um domínio (console)](#add-tag-domains-console)
+ [Exibir tags para um domínio (console)](#list-tag-domains-console)
+ [Editar tags para um domínio (console)](#update-tag-domains-console)
+ [Remover tags de um domínio (console)](#delete-tag-domains-console)

### Adicionar tags a um domínio (console)
<a name="add-tag-domains-console"></a>

Você pode usar o console para adicionar tags a um domínio existente.

1. Abra o AWS CodeArtifact console em [https://console.aws.amazon.com/codesuite/codeartifact/home](https://console.aws.amazon.com/codesuite/codeartifact/home).

1. Na página **Domínios**, escolha o domínio ao qual deseja adicionar tags.

1. Expanda a seção **Detalhes**.

1. Em **Tags de domínio**, escolha **Adicionar tags de domínio** se não houver tags no domínio ou escolha **Exibir e editar tags de domínio**, se houver.

1. Selecione **Adicionar nova tag**.

1. Nos campos **Chave** e **Valor**, insira o texto para cada tag que deseja adicionar. (O campo **Value (Valor)** é opcional.) Por exemplo, em **Key (Chave)**, insira **Name**. Em **Valor**, informe **Test**.  
![A configuração do domínio.](http://docs.aws.amazon.com/pt_br/codeartifact/latest/ug/images/domain-add-tag-console.png)

1. (Opcional) Escolha **Add tag (Adicionar tag)** para adicionar mais linhas e inserir mais tags.

1. Escolha **Atualizar domínio**.

### Exibir tags para um domínio (console)
<a name="list-tag-domains-console"></a>

Você pode usar o console para listar tags de domínios existentes.

1. Abra o AWS CodeArtifact console em [https://console.aws.amazon.com/codesuite/codeartifact/home](https://console.aws.amazon.com/codesuite/codeartifact/home).

1. Na página **Domínios**, escolha o domínio em que deseja exibir tags.

1. Expanda a seção **Detalhes**.

1. Em **Tags de domínio**, escolha **Exibir e editar tags de domínio**.
**nota**  
Se não houver tags adicionadas a esse domínio, o console lerá **Adicionar tags do domínio**.

### Editar tags para um domínio (console)
<a name="update-tag-domains-console"></a>

Você pode usar o console para editar as tags adicionadas ao domínio.

1. Abra o AWS CodeArtifact console em [https://console.aws.amazon.com/codesuite/codeartifact/home](https://console.aws.amazon.com/codesuite/codeartifact/home).

1. Na página **Domínios**, escolha o domínio em que deseja atualizar tags.

1. Expanda a seção **Detalhes**.

1. Em **Tags de domínio**, escolha **Exibir e editar tags de domínio**.
**nota**  
Se não houver tags adicionadas a esse domínio, o console lerá **Adicionar tags do domínio**.

1. Nos campos **Key (Chave)** e **Value (Valor)**, atualize os valores em cada campo conforme necessário. Por exemplo, para a chave **Name**, em **Value (Valor)**, altere **Test** para **Prod**.

1. Escolha **Atualizar domínio**.

### Remover tags de um domínio (console)
<a name="delete-tag-domains-console"></a>

Você pode usar o console para excluir tags de domínios.

1. Abra o AWS CodeArtifact console em [https://console.aws.amazon.com/codesuite/codeartifact/home](https://console.aws.amazon.com/codesuite/codeartifact/home).

1. Na página **Domínios**, escolha o domínio em que deseja remover tags.

1. Expanda a seção **Detalhes**.

1. Em **Tags de domínio**, escolha **Exibir e editar tags de domínio**.
**nota**  
Se não houver tags adicionadas a esse domínio, o console lerá **Adicionar tags do domínio**.

1. Ao lado da chave e do valor para cada tag que você deseja excluir, escolha **Remover**.

1. Escolha **Atualizar domínio**.