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.
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 de recursos 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.
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 #22.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
InvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionEntityNotFoundException
Acción UntagResource (Python: untag_resource)
Elimina etiquetas de 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 #22.El nombre de recurso de Amazon (ARN) del recurso del que se van a eliminar las etiquetas.
-
TagsToRemove– Obligatorio: matriz de cadenas UTF-8, con 50 cadenas como máximo.Etiquetas que se van a quitar de este recurso.
Respuesta
Sin parámetros de respuesta.
Errores
InvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionEntityNotFoundException
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 #22.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
