Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Etiquetado de dominios de Amazon OpenSearch Service

Las etiquetas te permiten asignar información arbitraria a un dominio de Amazon OpenSearch Service para que puedas categorizar y filtrar esa información. Una etiqueta es un par clave-valor que se define y se asocia a un OpenSearch dominio de servicio. Puede usar estas etiquetas para realizar un seguimiento de los costos agrupando los gastos de los recursos etiquetados de manera similar. AWS no aplica ningún significado semántico a tus etiquetas. Las etiquetas se interpretan estrictamente como cadenas de caracteres. Todas las etiquetas presentan los siguientes elementos:

Cada dominio OpenSearch de servicio tiene un conjunto de etiquetas, que contiene todas las etiquetas asignadas a ese dominio OpenSearch de servicio. AWS no asigna automáticamente ninguna etiqueta a los dominios OpenSearch de servicio. Un conjunto de etiquetas puede contener entre 0 y 50 etiquetas. Si agrega una etiqueta a un dominio con la misma clave que una etiqueta existente en un recurso, el nuevo valor sobrescribirá el antiguo.

Ejemplos de etiquetas

Puede utilizar una clave para definir una categoría, y el valor podría ser un elemento dentro de esa categoría. Por ejemplo, puede definir una clave de etiqueta project y un valor de etiqueta deSalix, que indiquen que el dominio de OpenSearch servicio está asignado al proyecto de Salix. También puede usar etiquetas para designar los dominios de OpenSearch servicio que se utilizan para pruebas o producción mediante una clave como environment=test oenvironment=production. Intente utilizar un conjunto coherente de claves de etiquetas para facilitar el seguimiento de los metadatos asociados a los dominios OpenSearch de servicio.

También puedes usar etiquetas para organizar tu AWS factura y reflejar tu propia estructura de costos. Para ello, regístrate para recibir tu Cuenta de AWS factura con los valores clave de las etiquetas incluidos. A continuación, para ver los costes de los recursos combinados, organice la información de facturación de acuerdo con los recursos que tienen los mismos valores de clave de etiqueta. Por ejemplo, puedes etiquetar varios dominios de OpenSearch servicio con pares clave-valor y, a continuación, organizar la información de facturación para ver el coste total de cada dominio en varios servicios. Para obtener más información, consulte Uso de etiquetas de asignación de costos en la documentación de administración de costos y facturación deAWS .

Uso de etiquetas (consola)

La consola es la forma más sencilla de etiquetas de un dominio.

Para eliminar una etiqueta, siga los mismos pasos y elija Quitar en la página Administrar etiquetas.

Para obtener más información sobre cómo utilizar la consola para trabajar con etiquetas, consulte Tag Editor en la Guía de introducción a la consola de administración deAWS .

Uso de etiquetas (AWS CLI)

Puede crear etiquetas de recursos mediante el AWS CLI --add-tags comando with.

Sintaxis

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

Ejemplo

En el siguiente ejemplo se crean dos etiquetas para el dominio registros:

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

Puede eliminar etiquetas de un dominio OpenSearch de servicio mediante el --remove-tags comando.

Sintaxis

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

Ejemplo

En el siguiente ejemplo se eliminan dos etiquetas del dominio logs que se crearon en el ejemplo anterior:

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

Puede ver las etiquetas existentes de un dominio de OpenSearch servicio con el comando: --list-tags

Sintaxis

list-tags --arn=<domain_arn>

Ejemplo

En el siguiente ejemplo se muestran todas las etiquetas de recursos del dominio logs:

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

Trabajar con etiquetas (AWS SDK)

AWS Los SDK (excepto los de Android e iOS) admiten todas las acciones definidas en la referencia de la API de Amazon OpenSearch Service, incluidas las AddTags operaciones ListTags yRemoveTags. Para obtener más información sobre la instalación y el uso de los AWS SDK, consulte los kits de desarrollo de AWS software.

Python

En este ejemplo, se utiliza el cliente Python de OpenSearchServicebajo nivel del SDK de AWS para Python (Boto) para añadir una etiqueta a un dominio, enumerar la etiqueta adjunta al dominio y eliminar una etiqueta del dominio. Debe proporcionar valores para DOMAIN_ARN, TAG_KEY y 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