# API de etiquetado en AWS Glue
<a name="aws-glue-api-tags"></a>

## Tipos de datos
<a name="aws-glue-api-tags-objects"></a>
+ [Estructura de etiquetas](#aws-glue-api-tags-Tag)

## Estructura de etiquetas
<a name="aws-glue-api-tags-Tag"></a>

El objeto `Tag` representa una etiqueta que se puede asignar a un recurso de AWS. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario.

Para obtener más información acerca de las etiquetas y controlar el acceso a los recursos en AWS Glue, consulte [Etiquetas de AWS en AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html) y [Especificación de ARN de recursos de AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/glue-specifying-resource-arns.html) en la Guía para desarrolladores.

**Campos**
+ `key`: cadena UTF-8, con 1 byte de largo como mínimo y 128 bytes de largo como máximo.

  La clave de la etiqueta. La clave es necesaria para crear una etiqueta en un objeto. La clave distingue entre mayúsculas y minúsculas y no debe contener el prefijo aws.
+ `value`: cadena UTF-8 de 256 bytes de largo como máximo.

  El valor de la etiqueta. El valor es opcional para crear una etiqueta en un objeto. El valor distingue entre mayúsculas y minúsculas y no debe contener el prefijo aws.

## Operaciones
<a name="aws-glue-api-tags-actions"></a>
+ [Acción TagResource (Python: tag\$1resource)](#aws-glue-api-tags-TagResource)
+ [Acción UntagResource (Python: untag\$1resource)](#aws-glue-api-tags-UntagResource)
+ [Acción GetTags (Python: get\$1tags)](#aws-glue-api-tags-GetTags)

## Acción TagResource (Python: tag\$1resource)
<a name="aws-glue-api-tags-TagResource"></a>

Agrega etiquetas a un recurso. Una etiqueta es una marca que se puede asignar a un recurso de AWS. En AWS Glue, solamente se pueden etiquetar ciertos recursos. Para obtener más información acerca de qué recursos pueden etiquetarse, consulte [Etiquetas de AWS en AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/monitor-tags.html).

Además de los permisos de etiquetado para llamar a las API relacionadas con etiquetas, también necesita el permiso `glue:GetConnection` para llamar a las API de etiquetado en las conexiones y el permiso `glue:GetDatabase` para llamar a las API de etiquetado en las bases de datos.

**Solicitud**
+ `ResourceArn` – *Obligatorio:* cadena UTF-8, con 1 byte de largo como mínimo y 10 240 bytes de largo como máximo, que coincide con el [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  ARN del recurso de AWS Glue al que se van a agregar las etiquetas. Para obtener más información acerca de los ARN de recursos de AWS Glue, consulte [Patrones de cadena de ARN de AWS Glue](https://docs.aws.amazon.com/glue/latest/dg/aws-glue-api-common.html#aws-glue-api-regex-aws-glue-arn-id).
+ `TagsToAdd` – *Obligatorio:* matriz de mapas de pares clave-valor, con 50 pares como máximo.

  Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes.

  Cada valor es una cadena UTF-8 que no tiene más de 256 bytes de largo.

  Etiquetas que se van a añadir a este recurso.

**Respuesta**
+ *Sin parámetros de respuesta.*

**Errores**
+ `ResourceNotFoundException`

## Acción UntagResource (Python: untag\$1resource)
<a name="aws-glue-api-tags-UntagResource"></a>

Quita las etiquetas especificadas de un recurso de integración.

**Solicitud**
+ `ResourceArn` – *Obligatorio:* cadena UTF-8, con 1 byte de largo como mínimo y 10 240 bytes de largo como máximo, que coincide con el [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  Nombre de recurso de Amazon (ARN) del recurso de integración.
+ `TagsToRemove` – *Obligatorio:* matriz de cadenas UTF-8, con 50 cadenas como máximo.

  Una lista de las etiquetas de metadatos que se eliminará del recurso.

**Respuesta**
+ *Sin parámetros de respuesta.*

**Errores**
+ `ResourceNotFoundException`

## Acción GetTags (Python: get\$1tags)
<a name="aws-glue-api-tags-GetTags"></a>

Recupera una lista de etiquetas asociadas a un recurso.

**Solicitud**
+ `ResourceArn` – *Obligatorio:* cadena UTF-8, con 1 byte de largo como mínimo y 10 240 bytes de largo como máximo, que coincide con el [Custom string pattern #50](aws-glue-api-common.md#regex_50).

  El nombre de recurso de Amazon (ARN) del recurso del que se van a recuperar etiquetas.

**Respuesta**
+ `Tags`: matriz de mapas de pares de clave-valor, con 50 pares como máximo.

  Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes.

  Cada valor es una cadena UTF-8 que no tiene más de 256 bytes de largo.

  Etiquetas solicitadas

**Errores**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `EntityNotFoundException`