View a markdown version of this page

API de etiquetado en AWS Glue - AWS Glue

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
  • ResourceArnObligatorio: 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.

  • TagsToAddObligatorio: 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
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

Acción UntagResource (Python: untag_resource)

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

Solicitud
  • ResourceArnObligatorio: 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.

  • TagsToRemoveObligatorio: 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
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

Acción GetTags (Python: get_tags)

Recupera una lista de etiquetas asociadas a un recurso.

Solicitud
  • ResourceArnObligatorio: 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
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • EntityNotFoundException