Perfiles de uso
La API de perfiles de uso describe los tipos de datos y la API relacionados con la creación, actualización o visualización de los perfiles de uso en AWS Glue.
Tipos de datos
Estructura ProfileConfiguration
Especifica los valores de trabajo y sesión que un administrador configura en un perfil de uso de AWS Glue.
Campos
-
SessionConfiguration: matriz de mapas de pares clave-valor.Cada clave es una cadena UTF-8 con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.
Cada valor es un objeto A ConfigurationObject.
Un mapa de clave-valor de los parámetros de configuración de las sesiones de AWS Glue.
-
JobConfiguration: matriz de mapas de pares clave-valor.Cada clave es una cadena UTF-8 con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.
Cada valor es un objeto A ConfigurationObject.
Un mapa de clave-valor de los parámetros de configuración de los trabajos de AWS Glue.
Estructura ConfigurationObject
Especifica los valores que un administrador establece para cada parámetro de trabajo o sesión configurado en un perfil de uso de AWS Glue.
Campos
-
DefaultValue: cadena UTF-8, con 1 byte de largo como mínimo y 128 bytes de largo como máximo, que coincide con el Custom string pattern #35.Un valor predeterminado para el parámetro.
-
AllowedValues: matriz de cadenas UTF-8.Una lista de valores permitidos para el parámetro.
-
MinValue: cadena UTF-8, con 1 byte de largo como mínimo y 128 bytes de largo como máximo, que coincide con el Custom string pattern #35.Un valor mínimo permitido para el parámetro.
-
MaxValue: cadena UTF-8, con 1 byte de largo como mínimo y 128 bytes de largo como máximo, que coincide con el Custom string pattern #35.Un valor máximo permitido para el parámetro.
Estructura UsageProfileDefinition
Describe un perfil de uso de AWS Glue.
Campos
-
Name: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El nombre del perfil de uso.
-
Description: cadena de descripción de un máximo de 2048 bytes de largo, que coincide con el URI address multi-line string pattern.Una descripción del perfil de uso.
-
CreatedOn: marca temporal.La fecha y la hora en que se creó el perfil de uso.
-
LastModifiedOn: marca temporal.La fecha y la hora en que se modificó el perfil de uso por última vez.
Operaciones
Acción CreateUsageProfile (Python: create_usage_profile)
Crea un perfil de uso de AWS Glue.
Solicitud
-
Name: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El nombre del perfil de uso.
-
Description: cadena de descripción de un máximo de 2048 bytes de largo, que coincide con el URI address multi-line string pattern.Una descripción del perfil de uso.
-
Configuration: obligatorio: objeto ProfileConfiguration.Un objeto
ProfileConfigurationque especifica los valores de trabajo y sesión del perfil. -
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.
Una lista de etiquetas aplicadas al perfil de uso.
Respuesta
-
Name: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El nombre del perfil de uso que se creó.
Errores
InvalidInputExceptionInternalServiceExceptionAlreadyExistsExceptionOperationTimeoutExceptionResourceNumberLimitExceededExceptionOperationNotSupportedException
Acción GetUsageProfile (Python: get_usage_profile)
Recupera información sobre el perfil de uso de AWS Glue especificado.
Solicitud
-
Name: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El nombre del perfil de uso que se va a recuperar.
Respuesta
-
Name: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El nombre del perfil de uso.
-
Description: cadena de descripción de un máximo de 2048 bytes de largo, que coincide con el URI address multi-line string pattern.Una descripción del perfil de uso.
-
Configuration: un objeto ProfileConfiguration.Un objeto
ProfileConfigurationque especifica los valores de trabajo y sesión del perfil. -
CreatedOn: marca temporal.La fecha y la hora en que se creó el perfil de uso.
-
LastModifiedOn: marca temporal.La fecha y la hora en que se modificó el perfil de uso por última vez.
Errores
InvalidInputExceptionInternalServiceExceptionEntityNotFoundExceptionOperationTimeoutExceptionOperationNotSupportedException
Acción UpdateUsageProfile (Python: update_usage_profile)
Actualiza un perfil de uso de AWS Glue.
Solicitud
-
Name: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El nombre del perfil de uso.
-
Description: cadena de descripción de un máximo de 2048 bytes de largo, que coincide con el URI address multi-line string pattern.Una descripción del perfil de uso.
-
Configuration: obligatorio: objeto ProfileConfiguration.Un objeto
ProfileConfigurationque especifica los valores de trabajo y sesión del perfil.
Respuesta
-
Name: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El nombre del perfil de uso que se actualizó.
Errores
InvalidInputExceptionInternalServiceExceptionEntityNotFoundExceptionOperationTimeoutExceptionOperationNotSupportedExceptionConcurrentModificationException
Acción DeleteUsageProfile (Python: delete_usage_profile)
Elimina el perfil de uso de AWS Glue especificado.
Solicitud
-
Name: obligatorio: cadena UTF-8, con 1 byte de largo como mínimo y 255 bytes de largo como máximo, que coincide con el Single-line string pattern.El nombre del perfil de uso que se va a eliminar.
Respuesta
Sin parámetros de respuesta.
Errores
InvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionOperationNotSupportedException
Acción ListUsageProfiles (Python: list_usage_profiles)
Enumera todos los perfiles de uso de AWS Glue.
Solicitud
-
NextToken: cadena UTF-8 de 400 000 bytes de largo como máximo.Token de continuación, incluido si se trata de una llamada de continuidad.
-
MaxResults: número (entero), mayor que 1 y menor que 200.El número máximo de perfiles de uso que se devolverán en una sola respuesta.
Respuesta
-
Profiles: matriz de objetos UsageProfileDefinition.Una lista de objetos del perfil de uso (
UsageProfileDefinition). -
NextToken: cadena UTF-8 de 400 000 bytes de largo como máximo.Un token de continuación, presente si el segmento de lista actual no es el último.
Errores
InternalServiceExceptionOperationTimeoutExceptionInvalidInputExceptionOperationNotSupportedException