

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Marquer un domaine dans CodeArtifact
<a name="tag-domains"></a>

Les balises sont des paires clé-valeur associées aux ressources AWS. Vous pouvez appliquer des balises à vos domaines dans CodeArtifact. Pour plus d'informations sur le balisage CodeArtifact des ressources, les cas d'utilisation, les contraintes de clé et de valeur de balise et les types de ressources pris en charge, consultez[Balisage des ressources](tag-resources.md).

Vous pouvez utiliser la CLI pour spécifier des balises lorsque vous créez un domaine. Vous pouvez utiliser la console ou la CLI pour ajouter ou supprimer des balises et mettre à jour les valeurs des balises dans un domaine. Vous pouvez ajouter jusqu'à 50 balises à chaque domaine.

**Topics**
+ [Domaines de balises (CLI)](#tag-domains-tag-cli)
+ [Domaines de balises (console)](#tag-domains-console)

## Domaines de balises (CLI)
<a name="tag-domains-tag-cli"></a>

Vous pouvez utiliser la CLI pour gérer les balises de domaine.

**Topics**
+ [Ajouter des balises à un domaine (CLI)](#add-domains-tag-cli)
+ [Afficher les balises d'un domaine (CLI)](#list-domains-tag-cli)
+ [Modifier les balises d'un domaine (CLI)](#update-domains-tag-cli)
+ [Supprimer les balises d'un domaine (CLI)](#delete-domains-tag-cli)

### Ajouter des balises à un domaine (CLI)
<a name="add-domains-tag-cli"></a>

Vous pouvez utiliser la console ou le AWS CLI pour baliser des domaines.

Pour ajouter une balise à un domaine lorsque vous le créez, consultez[Création d'un référentiel](create-repo.md).

Dans ces étapes, nous supposons que vous avez déjà installé une version récente de l’ AWS CLI ou que vous avez procédé à une mise à jour vers la version actuelle. Pour plus d’informations, consultez [Installing the AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) (Installation de).

Sur le terminal ou sur la ligne de commande, exécutez la **tag-resource** commande en spécifiant le nom de ressource Amazon (ARN) du domaine dans lequel vous souhaitez ajouter des balises, ainsi que la clé et la valeur de la balise que vous souhaitez ajouter.

**Note**  
Pour obtenir l'ARN du domaine, exécutez la `describe-domain` commande suivante :  

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

Vous pouvez ajouter plusieurs balises à un domaine. Par exemple, pour baliser un domaine nommé *my\$1domain* avec deux balises, une clé de balise nommée *key1* avec la valeur de *value1* balise et une clé de balise nommée *key2* avec la valeur de balise 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
```

En cas de succès, cette commande n'a aucune sortie.

### Afficher les balises d'un domaine (CLI)
<a name="list-domains-tag-cli"></a>

Procédez comme suit pour utiliser le AWS CLI afin d'afficher les AWS balises d'un domaine. Si aucune balise n’a été ajoutée, la liste renvoyée est vide.

Sur le terminal ou sur la ligne de commande, exécutez la **list-tags-for-resource** commande avec l'Amazon Resource Name (ARN) du domaine.

**Note**  
Pour obtenir l'ARN du domaine, exécutez la `describe-domain` commande suivante :  

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

Par exemple, pour afficher la liste des clés de balise et des valeurs de balise pour un domaine nommé *my\$1domain* avec la valeur `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
```

Si elle aboutit, cette commande renvoie des informations similaires à ce qui suit :

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

### Modifier les balises d'un domaine (CLI)
<a name="update-domains-tag-cli"></a>

Procédez comme suit pour utiliser le AWS CLI pour modifier une balise pour un domaine. Vous pouvez modifier la valeur d'une clé existante ou ajouter une autre clé. Vous pouvez également supprimer des balises d'un domaine, comme indiqué dans la section suivante.

Sur le terminal ou sur la ligne de commande, exécutez la **tag-resource** commande en spécifiant l'ARN du domaine dans lequel vous souhaitez mettre à jour une balise, ainsi que la clé et la valeur de la balise :

**Note**  
Pour obtenir l'ARN du domaine, exécutez la `describe-domain` commande suivante :  

```
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
```

En cas de succès, cette commande n'a aucune sortie.

### Supprimer les balises d'un domaine (CLI)
<a name="delete-domains-tag-cli"></a>

Procédez comme suit pour utiliser le AWS CLI pour supprimer une balise d'un domaine.

**Note**  
Si vous supprimez un domaine, toutes les associations de balises sont supprimées du domaine supprimé. Il n'est pas nécessaire de supprimer les balises avant de supprimer un domaine.

Sur le terminal ou sur la ligne de commande, exécutez la **untag-resource** commande en spécifiant l'ARN du domaine dans lequel vous souhaitez supprimer les balises et la clé de balise de la balise que vous souhaitez supprimer.

**Note**  
Pour obtenir l'ARN du domaine, exécutez la `describe-domain` commande suivante :  

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

Par exemple, pour supprimer plusieurs balises sur un domaine nommé *mydomain* avec les clés de balise *key1* et *key2* :

```
aws codeartifact untag-resource --resource-arn arn:aws:codeartifact:us-west-2:123456789012:domain/my_domain --tag-keys key1 key2
```

En cas de succès, cette commande n'a aucune sortie. Après avoir supprimé les balises, vous pouvez afficher les balises restantes sur le domaine à l'aide de la `list-tags-for-resource` commande.

## Domaines de balises (console)
<a name="tag-domains-console"></a>

Vous pouvez utiliser la console ou la CLI pour baliser des ressources.

**Topics**
+ [Ajouter des balises à un domaine (console)](#add-tag-domains-console)
+ [Afficher les balises d'un domaine (console)](#list-tag-domains-console)
+ [Modifier les balises d'un domaine (console)](#update-tag-domains-console)
+ [Supprimer les balises d'un domaine (console)](#delete-tag-domains-console)

### Ajouter des balises à un domaine (console)
<a name="add-tag-domains-console"></a>

Vous pouvez utiliser la console pour ajouter des balises à un domaine existant.

1. Ouvrez la AWS CodeArtifact console sur [https://console.aws.amazon.com/codesuite/codeartifact/home](https://console.aws.amazon.com/codesuite/codeartifact/home).

1. Sur la page **Domaines**, choisissez le domaine auquel vous souhaitez ajouter des balises.

1. Développez la section **Détails**.

1. Sous **Balises de domaine**, choisissez **Ajouter des balises de domaine** s'il n'y en a aucune sur le domaine, ou choisissez **Afficher et modifier les balises de domaine** s'il y en a.

1. Sélectionnez **Ajouter une nouvelle balise**.

1. Dans les champs **Clé** et **Valeur**, entrez le texte de chaque balise que vous souhaitez ajouter. (Le champ **Valeur** est facultatif.) Par exemple, dans **Clé**, saisissez **Name**. Dans **Value (Valeur)**, entrez **Test**.  
![\[La configuration du domaine.\]](http://docs.aws.amazon.com/fr_fr/codeartifact/latest/ug/images/domain-add-tag-console.png)

1. (Facultatif) Choisissez **Add tag (Ajouter une balise)** pour ajouter d'autres lignes et saisir d'autres balises.

1. Choisissez **Mettre à jour le domaine**.

### Afficher les balises d'un domaine (console)
<a name="list-tag-domains-console"></a>

Vous pouvez utiliser la console pour répertorier les balises des domaines existants.

1. Ouvrez la AWS CodeArtifact console sur [https://console.aws.amazon.com/codesuite/codeartifact/home](https://console.aws.amazon.com/codesuite/codeartifact/home).

1. Sur la page **Domaines**, choisissez le domaine dans lequel vous souhaitez afficher les balises.

1. Développez la section **Détails**.

1. Sous **Balises de domaine**, choisissez **Afficher et modifier les balises de domaine**.
**Note**  
Si aucune balise n'est ajoutée à ce domaine, la console affichera **Ajouter des balises de domaine**.

### Modifier les balises d'un domaine (console)
<a name="update-tag-domains-console"></a>

Vous pouvez utiliser la console pour modifier les balises qui ont été ajoutées au domaine.

1. Ouvrez la AWS CodeArtifact console sur [https://console.aws.amazon.com/codesuite/codeartifact/home](https://console.aws.amazon.com/codesuite/codeartifact/home).

1. Sur la page **Domaines**, choisissez le domaine dans lequel vous souhaitez mettre à jour les balises.

1. Développez la section **Détails**.

1. Sous **Balises de domaine**, choisissez **Afficher et modifier les balises de domaine**.
**Note**  
Si aucune balise n'est ajoutée à ce domaine, la console affichera **Ajouter des balises de domaine**.

1. Dans les champs **Clé** et **Valeur**, mettez à jour les valeurs dans chaque champ selon vos besoins. Par exemple, pour la clé **Name**, dans **Valeur**, remplacez **Test** par **Prod**.

1. Choisissez **Mettre à jour le domaine**.

### Supprimer les balises d'un domaine (console)
<a name="delete-tag-domains-console"></a>

Vous pouvez utiliser la console pour supprimer des balises de domaines.

1. Ouvrez la AWS CodeArtifact console sur [https://console.aws.amazon.com/codesuite/codeartifact/home](https://console.aws.amazon.com/codesuite/codeartifact/home).

1. Sur la page **Domaines**, choisissez le domaine dans lequel vous souhaitez supprimer les balises.

1. Développez la section **Détails**.

1. Sous **Balises de domaine**, choisissez **Afficher et modifier les balises de domaine**.
**Note**  
Si aucune balise n'est ajoutée à ce domaine, la console affichera **Ajouter des balises de domaine**.

1. À côté de la clé et de la valeur de chaque balise que vous souhaitez supprimer, choisissez **Supprimer**.

1. Choisissez **Mettre à jour le domaine**.