

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 colecciones de Amazon OpenSearch Serverless
<a name="tag-collection"></a>

Las etiquetas le permiten asignar información arbitraria a una colección de Amazon OpenSearch Serverless para que pueda categorizar y filtrar esa información. Una *etiqueta* es una etiqueta de metadatos que usted asigna o que AWS asigna a un recurso. AWS 

Cada etiqueta consta de una *clave* y un *valor*. En el caso de etiquetas que usted asigna, debe definir la clave y el valor. Por ejemplo, puede definir la clave como `stage` y el valor de un recurso como `test`.

Con las etiquetas, puede identificar y organizar sus AWS recursos. Muchos AWS servicios admiten el etiquetado, por lo que puede asignar la misma etiqueta a los recursos de diferentes servicios para indicar que los recursos están relacionados. Por ejemplo, puedes asignar la misma etiqueta a una colección OpenSearch sin servidor que a un dominio de Amazon OpenSearch Service.

En OpenSearch Serverless, el recurso principal es una colección. Puede usar la consola de OpenSearch servicio AWS CLI, las operaciones de la API OpenSearch sin servidor o la AWS SDKs para agregar, administrar y eliminar etiquetas de una colección.

## Permisos necesarios
<a name="collection-tag-permissions"></a>

OpenSearch Serverless utiliza los siguientes permisos AWS Identity and Access Management Access Analyzer (IAM) para etiquetar colecciones:
+ `aoss:TagResource`
+ `aoss:ListTagsForResource`
+ `aoss:UntagResource`

# Etiquetado de colecciones (consola)
<a name="tag-collection-console"></a>

La consola es la forma más sencilla para etiquetar un dominio.

****Para crear una etiqueta (consola)****

1. Inicia sesión en la consola OpenSearch de Amazon Service desde [https://console.aws.amazon.com/aos/casa](https://console.aws.amazon.com/aos/home ).

1. Expanda **Serverless** (Sin servidor) en el panel de navegación de la izquierda y seleccione **Collections** (Colecciones).

1. Seleccione la colección a la 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 colecciones (AWS CLI)
<a name="tag-collection-cli"></a>

Para etiquetar una colección mediante el AWS CLI, envía una [TagResource](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_TagResource.html)solicitud: 

```
aws opensearchserverless tag-resource
  --resource-arn arn:aws:aoss:us-east-1:123456789012:collection/my-collection 
  --tags Key=service,Value=aoss Key=source,Value=logs
```

Vea las etiquetas existentes de una colección con el [ListTagsForResource](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_ListTagsForResource.html)comando:

```
aws opensearchserverless list-tags-for-resource
  --resource-arn arn:aws:aoss:us-east-1:123456789012:collection/my-collection
```

Elimine las etiquetas de una colección mediante el [UntagResource](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_UntagResource.html)comando:

```
aws opensearchserverless untag-resource
  --resource-arn arn:aws:aoss:us-east-1:123456789012:collection/my-collection
  --tag-keys service
```