API de etiquetado en AWS Glue
Tipos de datos
Estructura de etiquetas
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 y Especificación de ARN del recurso de AWS Glue 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
Acción TagResource (Python: tag_resource)
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.
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 #47.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.
-
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
EntityNotFoundExceptionInvalidInputExceptionInternalServiceException
Acción UntagResource (Python: untag_resource)
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 #47.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
EntityNotFoundExceptionInvalidInputExceptionInternalServiceException
Acción GetTags (Python: get_tags)
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 #47.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
InvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionEntityNotFoundException