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 las canalizaciones de Amazon OpenSearch Ingestion
<a name="tag-pipeline"></a>

Las etiquetas le permiten asignar información arbitraria a una canalización OpenSearch de Amazon Ingestion 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`.

Las etiquetas lo ayudan a hacer lo siguiente:
+ Identifique y organice 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 canalización de OpenSearch ingestión que a un dominio de Amazon OpenSearch Service.
+ Realiza un seguimiento de tus AWS costes. Estas etiquetas se activan en el Administración de facturación y costos de AWS panel de control. AWS utiliza las etiquetas para clasificar los costes y entregarle un informe mensual de asignación de costes. 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 [Guía del usuario de AWS Billing](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/).
+ Restrinja el acceso a las canalizaciones mediante el control de acceso basado en atributos. Para obtener más información, consulte [Controlling access based on tag keys](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys) en la Guía del usuario de IAM.

En OpenSearch Ingestión, el recurso principal es una canalización. Puede usar la consola de OpenSearch servicio, la AWS CLI, OpenSearch Ingestion APIs o AWS SDKs para agregar, administrar y eliminar etiquetas de una canalización.

**Topics**
+ [Permisos necesarios](#pipeline-tag-permissions)
+ [Uso de etiquetas (consola)](#tag-pipeline-console)
+ [Uso de etiquetas (AWS CLI)](#tag-pipeline-cli)

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

OpenSearch Ingestion utiliza los siguientes permisos AWS Identity and Access Management Access Analyzer (IAM) para etiquetar las canalizaciones:
+ `osis:TagResource`
+ `osis:ListTagsForResource`
+ `osis:UntagResource`

*Para obtener más información sobre cada permiso, consulte [las acciones, los recursos y las claves de condición de la OpenSearch ingestión en la Referencia](https://docs.aws.amazon.com/service-authorization/latest/reference/list_opensearchingestionservice.html) de autorización de servicios.*

## Uso de etiquetas (consola)
<a name="tag-pipeline-console"></a>

La consola es la forma más sencilla para etiquetar una canalización.

****Cómo crear una etiqueta****

1. Inicia sesión en la consola de Amazon OpenSearch Service en [https://console.aws.amazon.com/aos/osis/home](https://console.aws.amazon.com/aos/osis/home#osis/ingestion-pipelines). Estarás en la página de Pipelines.

1. Seleccione una canalización a la que desee agregar etiquetas y vaya a la pestaña **Etiquetas**.

1. Seleccione **Administrar** y **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 *.

## Uso de etiquetas (AWS CLI)
<a name="tag-pipeline-cli"></a>

Para etiquetar una canalización mediante el AWS CLI, envía una `TagResource` solicitud: 

```
aws osis tag-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline 
  --tags Key=service,Value=osis Key=source,Value=otel
```

Elimine las etiquetas de una canalización mediante el comando `UntagResource`:

```
aws osis untag-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline
  --tag-keys service
```

Consulte las etiquetas existentes para una canalización con el comando `ListTagsForResource`:

```
aws osis list-tags-for-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline
```