Marquage des domaines Amazon OpenSearch Service

Les balises vous permettent d'attribuer des informations arbitraires à un domaine Amazon OpenSearch Service afin que vous puissiez les classer et les filtrer en fonction de ces informations. Une balise est une paire clé-valeur que vous définissez et associez à un domaine de OpenSearch service. Vous pouvez utiliser ces balises pour suivre les coûts en regroupant les dépenses relatives à des ressources étiquetées de la même manière. AWS n'applique aucune signification sémantique à vos balises. Les balises sont interprétées de façon stricte, en tant que chaîne de caractères. Toutes les balises comprennent les éléments suivants :

Élément de balise	Description	Obligatoire
Clé de balise	il s'agit du nom de la balise. La clé doit être unique au domaine de OpenSearch service auquel elle est attachée. Pour obtenir une liste des restrictions de base sur les valeurs et les clés de balise, consultez User-Defined Tag Restrictions.	Oui
Valeur de balise	La valeur de balise correspond à la valeur de chaîne de la balise. Les valeurs de balise peuvent être null et ne doivent pas nécessairement être uniques dans un ensemble de balises. Par exemple, vous pouvez avoir une paire clé-valeur dans un ensemble de balises appelé projet/Trinity et centre-de-coûts/Trinity. Pour obtenir une liste des restrictions de base sur les valeurs et les clés de balise, consultez User-Defined Tag Restrictions.	Non

Chaque domaine OpenSearch de service possède un ensemble de balises qui contient toutes les balises attribuées à ce domaine OpenSearch de service. AWS n'attribue pas automatiquement de balises aux domaines OpenSearch de service. Un ensemble de balises peut contenir entre 0 et 50 balises. Si vous ajoutez une balise à un domaine doté de la même clé qu'une balise existante, la nouvelle valeur remplace l'ancienne.

Exemples de balisage

Vous pouvez utiliser une clé pour définir une catégorie, et la valeur de balise peut être un élément de cette catégorie. Par exemple, vous pouvez définir une clé de balise project et une valeur de balise deSalix, indiquant que le domaine de OpenSearch service est attribué au projet Salix. Vous pouvez également utiliser des balises pour désigner les domaines de OpenSearch service utilisés à des fins de test ou de production à l'aide d'une clé telle que environment=test ouenvironment=production. Essayez d'utiliser un ensemble cohérent de clés de balise pour faciliter le suivi des métadonnées associées aux domaines OpenSearch de service.

Vous pouvez également utiliser des balises pour organiser votre AWS facture afin de refléter votre propre structure de coûts. Pour ce faire, inscrivez-vous pour recevoir votre Compte AWS facture avec les valeurs clés du tag incluses. Ensuite, organisez vos informations de facturation en fonction des ressources possédant les mêmes valeurs de clé de balise pour voir le coût de vos ressources combinées. Par exemple, vous pouvez étiqueter plusieurs domaines de OpenSearch service avec des paires clé-valeur, puis organiser vos informations de facturation pour voir le coût total de chaque domaine pour plusieurs services. Pour plus d'informations, consultez Utilisation des balises d'allocation des coûts dans la documentation Gestion de la facturation et des coûtsAWS .

Note

Les balises sont mises en cache à des fins d'autorisation. De ce fait, les ajouts et les mises à jour des balises sur les domaines de OpenSearch service peuvent prendre plusieurs minutes avant d'être disponibles.

Utilisation des balises (console)

La console constitue le moyen le plus simple de baliser un domaine.

Pour créer une identification (console)

1. Accédez à https://aws.amazon.com, puis choisissez Se connecter à la console.

2. Sous Analytics, sélectionnez Amazon OpenSearch Service.

3. Sélectionnez le domaine auquel vous voulez ajouter des balises et accédez à l'onglet Tags (Balises).

4. Choisissez Manage (Gérer) et Add new tag (Ajouter une nouvelle balise).

5. Saisissez une clé de balise et une valeur de balise facultative.

6. Choisissez Save (Enregistrer).

Pour supprimer une balise, suivez les mêmes étapes et choisissez Remove (Supprimer) sur la page Manage tags (Gérer les balises).

Pour plus d'informations sur l'utilisation de la console avec des identifications, veuillez consulter Éditeur d'identification dans le Guide de démarrage de la console de gestionAWS .

Utilisation des balises (AWS CLI)

Vous pouvez créer des balises de ressources à l'aide AWS CLI de la --add-tags commande with.

Syntaxe

add-tags --arn=<domain_arn> --tag-list Key=<key>,Value=<value>

Paramètre	Description
--arn	Nom de ressource Amazon pour le domaine de OpenSearch service auquel le tag est attaché.
--tag-list	Ensemble de paires clé-valeur séparées par des espaces dans le format suivant : Key=<key>,Value=<value>

Exemple

L'exemple suivant crée deux balises pour le domaine journaux :

aws opensearch add-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs --tag-list Key=service,Value=OpenSearch Key=instances,Value=m3.2xlarge

Vous pouvez supprimer des balises d'un domaine de OpenSearch service à l'aide de la --remove-tags commande.

Syntaxe

remove-tags --arn=<domain_arn> --tag-keys Key=<key>,Value=<value>

Paramètre	Description
--arn	Amazon Resource Name (ARN) pour le domaine de OpenSearch service auquel le tag est attaché.
--tag-keys	Ensemble de paires clé-valeur séparées par des espaces que vous souhaitez supprimer du domaine de service. OpenSearch

Exemple

L'exemple suivant supprime les deux balises du domaine journaux qui ont été créées dans l'exemple précédent :

aws opensearch remove-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs --tag-keys service instances

Vous pouvez afficher les balises existantes pour un domaine de OpenSearch service à l'aide de la --list-tags commande suivante :

Syntaxe

list-tags --arn=<domain_arn>

Paramètre	Description
--arn	Amazon Resource Name (ARN) pour le domaine de OpenSearch service auquel les balises sont attachées.

Exemple

L'exemple suivant répertorie toutes les balises de ressources pour le domaine journaux :

aws opensearch list-tags --arn arn:aws:es:us-east-1:379931976431:domain/logs

Utilisation des balises (AWS SDK)

Les AWS SDK (à l'exception des SDK Android et iOS) prennent en charge toutes les actions définies dans le Amazon OpenSearch Service API Reference, y compris les opérations AddTagsListTags, etRemoveTags. Pour plus d'informations sur l'installation et l'utilisation des AWS SDK, consultez la section Kits de développementAWS logiciel.

Python

Cet exemple utilise le client Python de OpenSearchServicebas niveau du SDK AWS pour Python (Boto) pour ajouter une balise à un domaine, répertorier la balise attachée au domaine et supprimer une balise du domaine. Vous devez fournir des valeurs pour DOMAIN_ARN, TAG_KEY et TAG_VALUE.

import boto3
from botocore.config import Config  # import configuration

DOMAIN_ARN = ''  # ARN for the domain. i.e "arn:aws:es:us-east-1:123456789012:domain/my-domain
TAG_KEY = ''  # The name of the tag key. i.e 'Smileyface'
TAG_VALUE = ''  # The value assigned to the tag. i.e 'Practicetag'

# defines the configurations parameters such as region

my_config = Config(region_name='us-east-1')
client = boto3.client('opensearch', config=my_config)


# defines the client variable

def addTags():
    """Adds tags to the domain"""

    response = client.add_tags(ARN=DOMAIN_ARN,
                               TagList=[{'Key': TAG_KEY,
                                         'Value': TAG_VALUE}])

    print(response)


def listTags():
    """List tags that have been added to the domain"""

    response = client.list_tags(ARN=DOMAIN_ARN)
    print(response)


def removeTags():
    """Remove tags that have been added to the domain"""

    response = client.remove_tags(ARN=DOMAIN_ARN, TagKeys=[TAG_KEY])

    print('Tag removed')
    return response