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:
| Elemento de etiqueta | Description (Descripción) | Obligatorio |
| --- | --- | --- |
| Clave de etiqueta | La clave de la etiqueta es el nombre de la etiqueta. La clave debe ser exclusiva del dominio del OpenSearch servicio al que está asociada. Para obtener una lista de restricciones básicas relativas a las claves y valores de las etiquetas, consulte [Restricciones de las etiquetas definidas por el usuario](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html). | Sí |
| Valor de etiqueta | El valor de etiqueta es un valor de cadena en la etiqueta. Los valores de etiquetas pueden ser `null` y no tienen que ser únicos dentro de un conjunto de etiquetas. Por ejemplo, puede tener un par clave-valor en un conjunto de etiquetas de. project/Trinity and cost-center/Trinity Para obtener una lista de restricciones básicas relativas a las claves y valores de las etiquetas, consulte [Restricciones de las etiquetas definidas por el usuario](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html). | No |
Cada dominio OpenSearch de servicio tiene un conjunto de etiquetas, que contiene todas las etiquetas asignadas a ese dominio de OpenSearch 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 de`Salix`, 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` o`environment=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 costos 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](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) en la documentación de *administración de costos y facturación de AWS *.
**nota**
Las etiquetas se almacenan en caché con fines de autorización. Por este motivo, las adiciones y actualizaciones de las etiquetas de los dominios de OpenSearch servicio pueden tardar varios minutos en estar disponibles.
# Etiquetado de dominios (consola)
La consola es la forma más sencilla de etiquetas de un dominio.
****Para crear una etiqueta (consola)****
1. Vaya a [https://aws.amazon.com](https://aws.amazon.com/ ), y seleccione **Sign In to the Console (Inicie sesión en la consola)**.
1. En **Analytics**, selecciona **Amazon OpenSearch Service**.
1. Seleccione el dominio al que desee agregar etiquetas y vaya a la pestaña **Tags** (Etiquetas).
1. Seleccione **Administrar** y **Add new tag** (Agregar nueva etiqueta).
1. Introduzca una clave de etiqueta y un valor opcional.
1. Seleccione **guardar**.
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](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html) en la *Guía de introducción a la consola de administración de AWS *.
# Etiquetado de dominios (AWS CLI)
Puede crear etiquetas de recursos mediante el AWS CLI **--add-tags** comando with.
**Sintaxis**
`add-tags --arn= --tag-list Key=,Value=`
****
| Parámetro | Description (Descripción) |
| --- | --- |
| --arn | Nombre de recurso de Amazon para el dominio de OpenSearch servicio al que se adjunta la etiqueta. |
| --tag-list | Conjunto de pares de clave-valor separados por espacios con el siguiente formato: Key=,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= --tag-keys Key=,Value=`
****
| Parámetro | Description (Descripción) |
| --- | --- |
| --arn | Nombre de recurso de Amazon (ARN) para el dominio de OpenSearch servicio al que está asociada la etiqueta. |
| --tag-keys | Conjunto de pares clave-valor separados por espacios que desea eliminar del dominio del servicio. OpenSearch |
**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=`
****
| Parámetro | Description (Descripción) |
| --- | --- |
| --arn | Nombre de recurso de Amazon (ARN) para el dominio de OpenSearch servicio al que se adjuntan las etiquetas. |
**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
```
# Etiquetado de dominios (AWS SDKs)
Las AWS SDKs (excepto Android e iOS SDKs) admiten todas las acciones definidas en la [referencia de la API de Amazon OpenSearch Service](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/Welcome.html), incluidas las `AddTags` `RemoveTags` operaciones`ListTags`, y. Para obtener más información sobre la instalación y el uso de AWS SDKs, consulte los [kits de desarrollo de AWS software](https://aws.amazon.com/code).
## **Python**
En este ejemplo, se usa el cliente Python de [OpenSearchService](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html)bajo nivel del AWS SDK para Python (Boto) para agregar 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
```