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 vos ressources AWS Cloud Map
Une étiquette est une étiquette que vous attribuez à une AWS ressource. Chaque balise est constituée d’une *clé* et d’une *valeur* facultative que vous définissez.
Les balises vous permettent de classer vos AWS ressources en fonction, par exemple, de leur objectif, de leur propriétaire ou de leur environnement. Lorsque vous avez de nombreuses ressources de même type, vous pouvez rapidement identifier une ressource spécifique en fonction des balises que vous lui avez attribuées. Par exemple, vous pouvez définir un ensemble de balises pour vos AWS Cloud Map services afin de suivre le propriétaire et le niveau de pile de chaque service. Nous vous recommandons de concevoir un ensemble cohérent de clés de balise pour chaque type de ressource.
Les balises ne sont pas automatiquement affectées à vos ressources. Une fois que vous avez ajouté une balise, vous pouvez modifier les clés et valeurs de balise ou supprimer les balises d'une ressource à tout moment. Si vous supprimez une ressource, ses balises sont également supprimées.
Les balises n'ont aucune signification sémantique AWS Cloud Map et sont interprétées strictement comme des chaînes de caractères. Vous pouvez définir la valeur d’une balise sur une chaîne vide, mais vous ne pouvez pas définir la valeur d’une balise sur null. Si vous ajoutez une balise ayant la même clé qu’une balise existante sur cette ressource, la nouvelle valeur remplace l’ancienne valeur.
Vous pouvez travailler avec des balises à l'aide de l'API AWS Management Console AWS CLI, du et de l' AWS Cloud Map API.
Si vous utilisez Gestion des identités et des accès AWS (IAM), vous pouvez contrôler quels utilisateurs de votre AWS compte sont autorisés à créer, modifier ou supprimer des tags.
## Comment les ressources sont étiquetées
Vous pouvez étiqueter des AWS Cloud Map espaces de noms et des services nouveaux ou existants.
Si vous utilisez la AWS Cloud Map console, vous pouvez appliquer des balises aux nouvelles ressources lors de leur création ou aux ressources existantes à tout moment à l'aide de l'onglet **Tags** de la page de ressources correspondante.
Si vous utilisez l' AWS Cloud Map API, le ou un AWS SDK AWS CLI, vous pouvez appliquer des balises aux nouvelles ressources à l'aide du `tags` paramètre de l'action d'API correspondante ou aux ressources existantes à l'aide de l'action d'[TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html)API. Pour de plus amples informations, veuillez consulter [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html).
En outre, certaines actions de création de ressources vous permettent de spécifier des balises pour une ressource lors de la création de cette dernière. Si des balises ne peuvent pas être appliquées au cours de la création de ressources, le processus de création de ressources échoue. Cela garantit que les ressources que vous vouliez baliser lors de la création sont créées avec des balises spécifiées ou ne sont pas créées du tout. Si vous balisez des ressources au moment de la création, vous n'avez pas besoin d'exécuter de scripts de balisage personnalisés après la création des ressources.
Le tableau suivant décrit les AWS Cloud Map ressources qui peuvent être balisées et les ressources qui peuvent être balisées lors de leur création.
**Support de balisage pour les ressources AWS Cloud Map**
| Ressource | Prend en charge les étiquettes | Prend en charge la propagation des étiquettes | Supporte le balisage lors de la création (AWS Cloud Map API AWS CLI, AWS SDK) |
| --- | --- | --- | --- |
| AWS Cloud Map espaces de noms | Oui | Non Les balises d'espace de noms ne se propagent à aucune autre ressource associée à l'espace de noms. | Oui |
| AWS Cloud Map services | Oui | Non Les balises de service ne se propagent à aucune autre ressource associée au service. | Oui |
## Restrictions
Les restrictions de base suivantes s’appliquent aux balises :
+ Nombre maximum de balises pour chaque ressource : 50
+ Pour chaque ressource, chaque clé de balise doit être unique, et chaque clé de balise peut avoir une seule valeur.
+ Longueur de clé maximale : 128 caractères Unicode en UTF-8
+ Longueur de valeur maximale : 256 caractères Unicode en UTF-8
+ Si votre schéma de balisage est utilisé pour plusieurs AWS services et ressources, n'oubliez pas que d'autres services peuvent être soumis à des restrictions quant aux caractères autorisés. Les caractères généralement autorisés sont les lettres, les chiffres et les espaces représentables en UTF-8, ainsi que les caractères suivants : \$1 - = . \$1 : / @.
+ Les clés et valeurs de balise sont sensibles à la casse.
+ N'utilisez pas `aws:``AWS:`, ni aucune combinaison majuscules ou minuscules, comme un préfixe pour les clés ou les valeurs, car il est réservé à l'usage. AWS Vous ne pouvez pas modifier ni supprimer des clés ou valeurs d’étiquette ayant ce préfixe. Les balises comportant ce préfixe ne sont pas prises en compte dans votre tags-per-resource limite.
# Mise à jour des balises pour les AWS Cloud Map ressources
Utilisez les AWS CLI commandes ou opérations d' AWS Cloud Map API suivantes pour ajouter, mettre à jour, répertorier et supprimer les balises de vos ressources.
**Support de balisage pour les ressources AWS Cloud Map**
| Tâche | Action d’API | AWS CLI | AWS Tools for Windows PowerShell |
| --- | --- | --- | --- |
| Ajouter ou remplacer une ou plusieurs étiquettes. | [TagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_TagResource.html) | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/tag-resource.html) | [Ajouter une SDResource étiquette](https://docs.aws.amazon.com/powershell/v4/reference/items/Add-SDResourceTag.html) |
| Supprimer une ou plusieurs étiquettes. | [UntagResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_UntagResource.html) | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/untag-resource.html) | [Supprimer- SDResource Tag](https://docs.aws.amazon.com/powershell/v4/reference/items/Remove-SDResourceTag.html) |
| Répertorie les balises d'une ressource. | [ListTagsForResource](https://docs.aws.amazon.com/cloud-map/latest/api/API_ListTagsForResource.html) | [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/list-tags-for-resource.html) | [Obtenir le SDResource tag](https://docs.aws.amazon.com/powershell/v4/reference/items/Get-SDResourceTag.html) |
Les exemples suivants montrent comment ajouter ou supprimer les étiquettes d'une ressource à l'aide de l' AWS CLI.
**Exemple 1 : Baliser une ressource existante**
La commande suivante permet de baliser une ressource existante.
```
aws servicediscovery tag-resource --resource-arn resource_ARN --tags team=devs
```
**Exemple 2 : Supprimer la balise d'une ressource existante**
La commande suivante permet de supprimer une balise d'une ressource existante.
```
aws servicediscovery untag-resource --resource-arn resource_ARN --tag-keys tag_key
```
**Exemple 3 : Afficher la liste des balises d'une ressource**
La commande suivante permet de répertorier l'ensemble des étiquettes associées à une ressource existante.
```
aws servicediscovery list-tags-for-resource --resource-arn resource_ARN
```
Certaines actions de création de ressources vous permettent de spécifier des étiquettes lorsque vous créez la ressource. Les actions suivantes prennent en charge l'identification lors de la création.
| Tâche | Action d’API | AWS CLI | AWS Tools for Windows PowerShell |
| --- | --- | --- | --- |
| Crée un espace de noms HTTP | [CreateHttpNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateHttpNamespace.html) | [create-http-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-http-namespace.html) | [Nouveau- SDHttp Namespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDHttpNamespace.html) |
| Créer un espace de noms privé basé sur DNS | [CreatePrivateDnsNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreatePrivateDnsNamespace.html) | [create-private-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-private-dns-namespace.html) | [Nouveau- SDPrivate DnsNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDPrivateDnsNamespace.html) |
| Créer un espace de noms public basé sur DNS | [CreatePublicDnsNamespace](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreatePublicDnsNamespace.html) | [create-public-dns-namespace](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-public-dns-namespace.html) | [Nouveau- SDPublic DnsNamespace](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDPublicDnsNamespace.html) |
| Créer un service | [CreateService](https://docs.aws.amazon.com/cloud-map/latest/api/API_CreateService.html) | [create-service](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/create-service.html) | [Nouveau- SDService](https://docs.aws.amazon.com/powershell/v4/reference/items/New-SDService.html) |