# API del tipo de conexión La API del tipo de conexión describe la AP de AWS Glue para registrar, describir, eliminar y enumerar los tipos de conexión. ## API de administración de conexiones + [Acción RegisterConnectionType (Python: register\_connection\_type)](#aws-glue-api-catalog-connections-connections-type-RegisterConnectionType) + [Acción DeleteConnectionType (Python: delete\_connection\_type)](#aws-glue-api-catalog-connections-connections-type-DeleteConnectionType) + [Acción DescribeConnectionType (Python: describe\_connection\_type)](#aws-glue-api-catalog-connections-connections-type-DescribeConnectionType) + [Acción ListConnectionTypes (Python: list\_connection\_types)](#aws-glue-api-catalog-connections-connections-type-ListConnectionTypes) + [Estructura ConnectionTypeBrief](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief) + [Estructura ConnectionTypeVariant](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant) ## Acción RegisterConnectionType (Python: register\_connection\_type) Registra un tipo de conexión personalizado en AWS Glue en función de la configuración proporcionada. Esta operación permite a los clientes configurar conectores personalizados para cualquier origen de datos con API basadas en REST, lo que elimina la necesidad de crear conectores de Lambda personalizados. El tipo de conexión registrado almacena detalles sobre cómo los orígenes de REST interpretan las solicitudes y las respuestas, incluidas las propiedades de conexión, la configuración de autenticación y la configuración de REST con definiciones de entidad. Una vez registrados, los clientes pueden crear conexiones con este tipo de conexión y trabajar con ellas de la misma forma que con los conectores de AWS Glue compatibles de forma nativa. Admite varios tipos de autenticación, incluidas las configuraciones de autenticación básica, OAuth2 (credenciales de cliente, portador JWT, código de autorización) y personalizada. **Solicitud** + `ConnectionType`: *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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). El nombre del tipo de conexión. Debe tener entre 1 y 255 caracteres y debe llevar el prefijo “REST-” para indicar que connector está basado en REST. + `IntegrationType` – *Obligatorio:* cadena UTF-8 (valores válidos: `REST`). El tipo de integración de la conexión. En este momento solo se admite el protocolo “REST”. + `Description`: cadena UTF-8, no más de 1024 bytes de largo. Descripción del tipo de conexión. Puede tener hasta 2048 caracteres y proporciona detalles sobre el propósito y la funcionalidad del tipo de conexión. + `ConnectionProperties`: *obligatorio:* objeto [ConnectionPropertiesConfiguration](#aws-glue-api-catalog-connections-connections-type-ConnectionPropertiesConfiguration). Define la URL base y los parámetros de solicitud adicionales necesarios durante la creación de la conexión para este tipo de conexión. + `ConnectorAuthenticationConfiguration`: *obligatorio:* objeto [ConnectorAuthenticationConfiguration](#aws-glue-api-catalog-connections-connections-type-ConnectorAuthenticationConfiguration). Define los tipos de autenticación compatibles y las propiedades necesarias para este tipo de conexión, incluidos los métodos de autenticación básica, OAuth2 y personalizada. + `RestConfiguration`: *obligatorio:* objeto [RestConfiguration](#aws-glue-api-catalog-connections-connections-type-RestConfiguration). Define la configuración de solicitud y respuesta HTTP, el punto de conexión de validación y las configuraciones de entidad para las interacciones de la API de REST. + `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. Las etiquetas que asigna al tipo de conexión. **Respuesta** Contiene el nombre de recurso de Amazon (ARN) del tipo de conexión registrado recientemente. + `ConnectionTypeArn` – 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](aws-glue-api-common.md#regex_47). El nombre de recurso de Amazon (ARN) del tipo de conexión registrado. Este identificador único se puede utilizar para hacer referencia al tipo de conexión en otras operaciones de AWS Glue. **Errores** + `AlreadyExistsException` + `InvalidInputException` + `OperationTimeoutException` + `ResourceNumberLimitExceededException` + `InternalServiceException` ## Acción DeleteConnectionType (Python: delete\_connection\_type) Elimina un tipo de conexión personalizado en AWS Glue. El tipo de conexión debe existir y estar registrado para poder eliminarlo. Esta operación permite limpiar los recursos de los tipos de conexión y ayuda a mantener una administración adecuada del ciclo de vida de los tipos de conexión personalizados. **Solicitud** + `ConnectionType`: *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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). El nombre del tipo de conexión que se va a eliminar. Debe hacer referencia a un tipo de conexión registrado existente. **Respuesta** + *Sin parámetros de respuesta.* **Errores** + `EntityNotFoundException` + `InvalidInputException` + `OperationTimeoutException` + `InternalServiceException` + `AccessDeniedException` ## Acción DescribeConnectionType (Python: describe\_connection\_type) La API `DescribeConnectionType` proporciona todos los detalles de las opciones admitidas para un tipo de conexión determinado en AWS Glue. La respuesta incluye los detalles de la configuración de autenticación, que muestran los tipos y propiedades de autenticación compatibles, y la los detalles de RestConfiguration para los tipos de conexión personalizados basados en REST registrados a través de `RegisterConnectionType`. Consulte también: `ListConnectionTypes`, `RegisterConnectionType`, `DeleteConnectionType` **Solicitud** + `ConnectionType`: *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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). El nombre del tipo de conexión que se va a describir. **Respuesta** + `ConnectionType` – 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](aws-glue-api-common.md#aws-glue-api-regex-oneLine). El nombre del tipo de conexión. + `Description`: cadena UTF-8, no más de 1024 bytes de largo. Descripción del tipo de conexión. + `Capabilities`: un objeto [Capacidades](#aws-glue-api-catalog-connections-connections-type-Capabilities). Los tipos de autenticación, los tipos de interfaz de datos (entornos de computación) y las operaciones de datos de connector compatibles. + `ConnectionProperties`: matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes. Cada valor es un objeto A [Propiedad](#aws-glue-api-catalog-connections-connections-type-Property). Propiedades de conexión que son comunes en todos los entornos de computación. + `ConnectionOptions`: matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes. Cada valor es un objeto A [Propiedad](#aws-glue-api-catalog-connections-connections-type-Property). Devuelve las propiedades que se pueden establecer al crear una conexión en `ConnectionInput.ConnectionProperties`. `ConnectionOptions` define los parámetros que se pueden configurar en un script ETL de Spark en el mapa de opciones de conexión que se pasa a un marco de datos. + `AuthenticationConfiguration`: un objeto [AuthConfiguration](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration). El tipo de autenticación que se va a utilizar para la conexión. + `ComputeEnvironmentConfigurations`: matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes. Cada valor es un objeto A [ComputeEnvironmentConfiguration](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration). Entornos de computación compatibles con la conexión. + `PhysicalConnectionRequirements`: matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes. Cada valor es un objeto A [Propiedad](#aws-glue-api-catalog-connections-connections-type-Property). Requisitos físicos de una conexión, como las especificaciones de VPC, subred y grupo de seguridad. + `AthenaConnectionProperties`: matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes. Cada valor es un objeto A [Propiedad](#aws-glue-api-catalog-connections-connections-type-Property). Propiedades de conexión específicas del entorno de computación de Athena. + `PythonConnectionProperties`: matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes. Cada valor es un objeto A [Propiedad](#aws-glue-api-catalog-connections-connections-type-Property). Propiedades de conexión específicas del entorno de computación de Python. + `SparkConnectionProperties`: matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes. Cada valor es un objeto A [Propiedad](#aws-glue-api-catalog-connections-connections-type-Property). Propiedades de conexión específicas del entorno de computación de Spark. + `RestConfiguration`: un objeto [RestConfiguration](#aws-glue-api-catalog-connections-connections-type-RestConfiguration). Configuración de solicitud y respuesta HTTP, punto de conexión de validación y configuraciones de entidad para el origen de datos basado en REST. **Errores** + `ValidationException` + `InvalidInputException` + `InternalServiceException` ## Acción ListConnectionTypes (Python: list\_connection\_types) La API `ListConnectionTypes` proporciona un mecanismo de detección para saber cuáles son los tipos de conexión disponibles en AWS Glue. La respuesta contiene una lista de tipos de conexión con información detallada de alto nivel sobre qué se admite en cada tipo de conexión, incluidos los tipos de conexión integrados y los tipos de conexión personalizados registrados a través de `RegisterConnectionType`. Los tipos de conexión que se muestran son el un conjunto de opciones compatibles para el valor `ConnectionType` de la API `CreateConnection`. Consulte también: `DescribeConnectionType`, `RegisterConnectionType`, `DeleteConnectionType` **Solicitud** + `MaxResults`: número (entero) que no es inferior a 1 ni es superior a 1000. El número máximo de resultados que devolver. + `NextToken` – cadena UTF-8, con 1 byte de largo como mínimo y 2048 bytes de largo como máximo, que coincide con el [Custom string pattern #11](aws-glue-api-common.md#regex_11). Token de continuación si se trata de una llamada de continuidad. **Respuesta** + `ConnectionTypes`: matriz de objetos [ConnectionTypeBrief](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeBrief). Una lista de objetos `ConnectionTypeBrief` que contiene información breve sobre los tipos de conexión compatibles. + `NextToken` – cadena UTF-8, con 1 byte de largo como mínimo y 2048 bytes de largo como máximo, que coincide con el [Custom string pattern #11](aws-glue-api-common.md#regex_11). Un token de continuación, que está presente si el segmento de lista actual no es el último. **Errores** + `InternalServiceException` ## Estructura ConnectionTypeBrief Información breve sobre un tipo de conexión compatible que devuelve la API `ListConnectionTypes`. **Campos** + `ConnectionType` – Cadena UTF-8 (valores válidos: `JDBC` \| `SFTP` \| `MONGODB` \| `KAFKA` \| `NETWORK` \| `MARKETPLACE` \| `CUSTOM` \| `SALESFORCE` \| `VIEW_VALIDATION_REDSHIFT` \| `VIEW_VALIDATION_ATHENA` \| `GOOGLEADS` \| `GOOGLESHEETS` \| `GOOGLEANALYTICS4` \| `SERVICENOW` \| `MARKETO` \| `SAPODATA` \| `ZENDESK` \| `JIRACLOUD` \| `NETSUITEERP` \| `HUBSPOT` \| `FACEBOOKADS` \| `INSTAGRAMADS` \| `ZOHOCRM` \| `SALESFORCEPARDOT` \| `SALESFORCEMARKETINGCLOUD` \| `ADOBEANALYTICS` \| `SLACK` \| `LINKEDIN` \| `MIXPANEL` \| `ASANA` \| `STRIPE` \| `SMARTSHEET` \| `DATADOG` \| `WOOCOMMERCE` \| `INTERCOM` \| `SNAPCHATADS` \| `PAYPAL` \| `QUICKBOOKS` \| `FACEBOOKPAGEINSIGHTS` \| `FRESHDESK` \| `TWILIO` \| `DOCUSIGNMONITOR` \| `FRESHSALES` \| `ZOOM` \| `GOOGLESEARCHCONSOLE` \| `SALESFORCECOMMERCECLOUD` \| `SAPCONCUR` \| `DYNATRACE` \| `MICROSOFTDYNAMIC365FINANCEANDOPS` \| `MICROSOFTTEAMS` \| `BLACKBAUDRAISEREDGENXT` \| `MAILCHIMP` \| `GITLAB` \| `PENDO` \| `PRODUCTBOARD` \| `CIRCLECI` \| `PIPEDIVE` \| `SENDGRID` \| `AZURECOSMOS` \| `AZURESQL` \| `BIGQUERY` \| `BLACKBAUD` \| `CLOUDERAHIVE` \| `CLOUDERAIMPALA` \| `CLOUDWATCH` \| `CLOUDWATCHMETRICS` \| `CMDB` \| `DATALAKEGEN2` \| `DB2` \| `DB2AS400` \| `DOCUMENTDB` \| `DOMO` \| `DYNAMODB` \| `GOOGLECLOUDSTORAGE` \| `HBASE` \| `KUSTOMER` \| `MICROSOFTDYNAMICS365CRM` \| `MONDAY` \| `MYSQL` \| `OKTA` \| `OPENSEARCH` \| `ORACLE` \| `PIPEDRIVE` \| `POSTGRESQL` \| `SAPHANA` \| `SQLSERVER` \| `SYNAPSE` \| `TERADATA` \| `TERADATANOS` \| `TIMESTREAM` \| `TPCDS` \| `VERTICA`). El nombre del tipo de conexión. + `DisplayName`: cadena UTF-8, con 1 byte de largo como mínimo y 128 bytes de largo como máximo. El nombre en formato legible para humanos del tipo de conexión que aparece en la consola de AWS Glue. + `Vendor`: cadena UTF-8, con 1 byte de largo como mínimo y 128 bytes de largo como máximo. El nombre del vendedor o proveedor que creó o mantiene este tipo de conexión. + `Description`: cadena UTF-8, no más de 1024 bytes de largo. Descripción del tipo de conexión. + `Categories`: matriz de cadenas UTF-8. Lista de las categorías a las que pertenece este tipo de conexión. Las categorías permiten a los usuarios filtrar y encontrar los tipos de conexión adecuados según los casos de uso. + `Capabilities`: un objeto [Capacidades](#aws-glue-api-catalog-connections-connections-type-Capabilities). Los tipos de autenticación, los tipos de interfaz de datos (entornos de computación) y las operaciones de datos de connector compatibles. + `LogoUrl`: cadena UTF-8. URL del logotipo asociado a un tipo de conexión. + `ConnectionTypeVariants`: matriz de objetos [ConnectionTypeVariant](#aws-glue-api-catalog-connections-connections-type-ConnectionTypeVariant). Lista de variantes disponibles para este tipo de conexión. Las distintas variantes pueden ofrecer configuraciones especializadas para casos de uso específicos o implementaciones dentro del mismo tipo general de conexión. ## Estructura ConnectionTypeVariant Representa una variante de un tipo de conexión en AWS Glue. Las variantes de tipo de conexión ofrecen configuraciones y comportamientos específicos para distintas implementaciones del mismo tipo general de conexión. **Campos** + `ConnectionTypeVariantName`: cadena UTF-8, con 1 byte de largo como mínimo y 128 bytes de largo como máximo. Identificador único de la variante de tipo de conexión. Este nombre se usa internamente para identificar la variante específica de un tipo de conexión. + `DisplayName`: cadena UTF-8, con 1 byte de largo como mínimo y 128 bytes de largo como máximo. El nombre en formato legible para humanos de la variante del tipo de conexión que aparece en la consola de AWS Glue. + `Description`: cadena UTF-8, no más de 1024 bytes de largo. Descripción detallada de la variante del tipo de conexión, que incluye su propósito, casos de uso y cualquier requisito de configuración específico. + `LogoUrl`: cadena UTF-8. URL del logotipo asociado a una variante de tipo de conexión. ## datatypes + [Estructura de Validación](#aws-glue-api-catalog-connections-connections-type-Validation) + [Estructura AuthConfiguration](#aws-glue-api-catalog-connections-connections-type-AuthConfiguration) + [Estructura de capacidades](#aws-glue-api-catalog-connections-connections-type-Capabilities) + [Estructura de propiedad](#aws-glue-api-catalog-connections-connections-type-Property) + [Estructura AllowedValue](#aws-glue-api-catalog-connections-connections-type-AllowedValue) + [Estructura ComputeEnvironmentConfiguration](#aws-glue-api-catalog-connections-connections-type-ComputeEnvironmentConfiguration) ## Estructura de Validación Define cómo se realiza una validación en una propiedad de conexión. **Campos** + `ValidationType`: *obligatorio:* cadena UTF-8 (valores válidos: `REGEX` \| `RANGE`). El tipo de validación que se va a realizar, como `REGEX`. + `Patterns`: matriz de cadenas UTF-8. Una lista con los patrones que se aplican a la validación. + `Description`: *obligatorio:* cadena UTF-8, con 1 byte de largo como mínimo y 1024 como máximo. Una descripción de la validación. + `MaxLength`: número (entero). Longitud máxima de una propiedad de conexión de cadenas. + `Maximum`: número (entero). Valor máximo al especificar un tipo de validación `RANGE`. + `Minimum`: número (entero). Valor mínimo al especificar un tipo de validación `RANGE`. ## Estructura AuthConfiguration Es la configuración de autenticación de una conexión que devuelve la API `DescribeConnectionType`. **Campos** + `AuthenticationType`: *obligatorio:* objeto [Propiedad](#aws-glue-api-catalog-connections-connections-type-Property). El tipo de autenticación de una conexión. + `SecretArn`: un objeto [Propiedad](#aws-glue-api-catalog-connections-connections-type-Property). El nombre de recurso de Amazon (ARN) de Secrets Manager. + `OAuth2Properties`: matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes. Cada valor es un objeto A [Propiedad](#aws-glue-api-catalog-connections-connections-type-Property). Asignación de pares clave-valor para las propiedades de OAuth2. Cada valor es un objeto `Property`. + `BasicAuthenticationProperties`: matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes. Cada valor es un objeto A [Propiedad](#aws-glue-api-catalog-connections-connections-type-Property). Asignación de pares clave-valor para las propiedades de OAuth2. Cada valor es un objeto `Property`. + `CustomAuthenticationProperties`: matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes. Cada valor es un objeto A [Propiedad](#aws-glue-api-catalog-connections-connections-type-Property). Asignación de pares clave-valor para las propiedades de autenticación personalizadas. Cada valor es un objeto `Property`. ## Estructura de capacidades Especifica los tipos de autenticación compatibles que devuelve la API `DescribeConnectionType`. **Campos** + `SupportedAuthenticationTypes`: *obligatorio:* una matriz de cadenas UTF-8. Una lista de los tipos de autenticación compatibles. + `SupportedDataOperations`: *obligatorio:* una matriz de cadenas UTF-8. Una lista de las operaciones de datos compatibles. + `SupportedComputeEnvironments`: *obligatorio:* una matriz de cadenas UTF-8. Una lista de los entornos de computación compatibles. ## Estructura de propiedad Objeto que define un tipo de conexión para un entorno de computación. **Campos** + `Name`: *requerido:* cadena UTF-8 con una extensión de 1 byte como mínimo y 128 bytes como máximo. El nombre de la propiedad. + `Description`: *requerido:* cadena UTF-8 con una extensión de 1024 bytes como máximo. Una descripción de la propiedad. + `Required` – *Obligatorio:* Booleano. Indica si la propiedad es necesaria. + `DefaultValue`: cadena UTF-8. El valor predeterminado de la propiedad. + `PropertyTypes`: *obligatorio:* una matriz de cadenas UTF-8. Describe el tipo de propiedad. + `AllowedValues`: matriz de objetos [AllowedValue](#aws-glue-api-catalog-connections-connections-type-AllowedValue). Lista de objetos `AllowedValue` que representan los valores permitidos en la propiedad. + `DataOperationScopes`: matriz de cadenas UTF-8. Indica qué operaciones de datos se aplican a la propiedad. + `KeyOverride`: cadena UTF-8. Un nombre de clave que se usará al enviar esta propiedad en las solicitudes de API, si es diferente del nombre de visualización. + `PropertyLocation` – cadena UTF-8 (valores válidos: `HEADER` \| `BODY` \| `QUERY_PARAM` \| `PATH`). Especifica dónde debe incluirse esta propiedad en las solicitudes de REST; por ejemplo, en los encabezados, los parámetros de consulta o el cuerpo de la solicitud. ## Estructura AllowedValue Objeto que representa un valor permitido en la propiedad. **Campos** + `Description`: cadena UTF-8, no más de 1024 bytes de largo. Descripción del valor permitido. + `Value`: *requerido:* cadena UTF-8 con una extensión de 1 byte como mínimo y 128 bytes como máximo. El valor permitido de la propiedad. ## Estructura ComputeEnvironmentConfiguration Un objeto que contiene la configuración de un entorno de computación (como Spark, Python o Athena) y que devuelve la API `DescribeConnectionType`. **Campos** + `Name`: *requerido:* cadena UTF-8 con una extensión de 1 byte como mínimo y 128 bytes como máximo. Nombre para la configuración del entorno de computación. + `Description`: *requerido:* cadena UTF-8 con una extensión de 1024 bytes como máximo. La descripción del entorno de computación. + `ComputeEnvironment` – *Obligatorio:* cadena UTF-8 (valores válidos: `SPARK` \| `ATHENA` \| `PYTHON`). El tipo de entorno de computación. + `SupportedAuthenticationTypes`: *obligatorio:* una matriz de cadenas UTF-8. Tipos de autenticación compatibles en el entorno de computación. + `ConnectionOptions` – *Obligatorio:* matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes. Cada valor es un objeto A [Propiedad](#aws-glue-api-catalog-connections-connections-type-Property). Parámetros que se usan como opciones de conexión en el entorno de computación. + `ConnectionPropertyNameOverrides` – *Obligatorio:* matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes. Cada valor es una cadena UTF-8 con una extensión de 1 byte como mínimo o 128 bytes como máximo. El nombre de la propiedad de conexión se anula en el entorno de computación. + `ConnectionOptionNameOverrides` – *Obligatorio:* matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 con una longitud de entre 1 y 128 bytes. Cada valor es una cadena UTF-8 con una extensión de 1 byte como mínimo o 128 bytes como máximo. El nombre de la opción de conexión se anula en el entorno de computación. + `ConnectionPropertiesRequiredOverrides`: *obligatorio:* una matriz de cadenas UTF-8. Propiedades de conexión que son necesarias para realizar anulaciones en el entorno de computación. + `PhysicalConnectionPropertiesRequired`: booleano. Indica si `PhysicalConnectionProperties` son necesarias en el entorno de computación. ## Tipos de datos de conectores personalizados + [Estructura de ConnectionPropertiesConfiguration](#aws-glue-api-catalog-connections-connections-type-ConnectionPropertiesConfiguration) + [Estructura de ConnectorAuthenticationConfiguration](#aws-glue-api-catalog-connections-connections-type-ConnectorAuthenticationConfiguration) + [Estructura de ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty) + [Estructura de RestConfiguration](#aws-glue-api-catalog-connections-connections-type-RestConfiguration) + [Estructura de SourceConfiguration](#aws-glue-api-catalog-connections-connections-type-SourceConfiguration) + [Estructura de EntityConfiguration](#aws-glue-api-catalog-connections-connections-type-EntityConfiguration) + [Estructura de ResponseConfiguration](#aws-glue-api-catalog-connections-connections-type-ResponseConfiguration) + [Estructura de ResponseExtractionMapping](#aws-glue-api-catalog-connections-connections-type-ResponseExtractionMapping) + [Estructura de PaginationConfiguration](#aws-glue-api-catalog-connections-connections-type-PaginationConfiguration) + [Estructura de CursorConfiguration](#aws-glue-api-catalog-connections-connections-type-CursorConfiguration) + [Estructura de OffsetConfiguration](#aws-glue-api-catalog-connections-connections-type-OffsetConfiguration) + [Estructura de ExtractedParameter](#aws-glue-api-catalog-connections-connections-type-ExtractedParameter) + [Estructura de FieldDefinition](#aws-glue-api-catalog-connections-connections-type-FieldDefinition) + [Estructura de ConnectorOAuth2Properties](#aws-glue-api-catalog-connections-connections-type-ConnectorOAuth2Properties) + [Estructura de ClientCredentialsProperties](#aws-glue-api-catalog-connections-connections-type-ClientCredentialsProperties) + [Estructura de JWTBearerProperties](#aws-glue-api-catalog-connections-connections-type-JWTBearerProperties) + [Estructura de ConnectorAuthorizationCodeProperties](#aws-glue-api-catalog-connections-connections-type-ConnectorAuthorizationCodeProperties) + [Estructura de BasicAuthenticationProperties](#aws-glue-api-catalog-connections-connections-type-BasicAuthenticationProperties) + [Estructura de CustomAuthenticationProperties](#aws-glue-api-catalog-connections-connections-type-CustomAuthenticationProperties) + [Estructura de FilterConfiguration](#aws-glue-api-catalog-connections-connections-type-FilterConfiguration) + [Estructura de FilterOverrides](#aws-glue-api-catalog-connections-connections-type-FilterOverrides) + [Estructura de BetweenConfiguration](#aws-glue-api-catalog-connections-connections-type-BetweenConfiguration) + [Estructura de FilterStringConfiguration](#aws-glue-api-catalog-connections-connections-type-FilterStringConfiguration) ## Estructura de ConnectionPropertiesConfiguration Configuración que define la URL base y los parámetros de solicitud adicionales necesarios durante la creación de la conexión. **Campos** + `Url`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). La URL de la instancia base del punto de conexión al que se conectará este tipo de conexión. + `AdditionalRequestParameters`: matriz de objetos [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Pares clave-valor de parámetros de solicitud adicionales que pueden ser necesarios durante la creación de la conexión, como las versiones de la API o las opciones de configuración específicas del servicio. ## Estructura de ConnectorAuthenticationConfiguration Configuración que define los tipos de autenticación compatibles y las propiedades necesarias para el tipo de conexión. **Campos** + `AuthenticationTypes`: *obligatorio:* una matriz de cadenas UTF-8. Una lista de los tipos de autenticación compatibles con este tipo de conexión, como los métodos de autenticación básica, OAuth2 o personalizada. ## Estructura de ConnectorProperty Define una configuración de propiedades para los tipos de conexión, los valores predeterminados y el lugar donde se debe usar la propiedad en las solicitudes. **Campos** + `Name`: *requerido:* cadena UTF-8 con una extensión de 1 byte como mínimo y 128 bytes como máximo. El nombre de la propiedad. + `KeyOverride` – 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 #15](aws-glue-api-common.md#regex_15). Un nombre de clave que se usará al enviar esta propiedad en las solicitudes de API, si es diferente del nombre de visualización. + `Required` – *Obligatorio:* Booleano. Indica si la propiedad es necesaria. + `DefaultValue`: cadena UTF-8. El valor predeterminado de la propiedad. + `AllowedValues`: matriz de cadenas UTF-8. Lista de objetos `AllowedValue` que representan los valores permitidos en la propiedad. + `PropertyLocation` – cadena UTF-8 (valores válidos: `HEADER` \| `BODY` \| `QUERY_PARAM` \| `PATH`). Especifica dónde debe incluirse esta propiedad en las solicitudes de REST; por ejemplo, en los encabezados, los parámetros de consulta o el cuerpo de la solicitud. + `PropertyType`: *obligatorio:* cadena de UTF-8 (valores válidos: `USER_INPUT` \| `SECRET` \| `READ_ONLY` \| `UNUSED` \| `SECRET_OR_USER_INPUT`). El tipo de datos de esta propiedad + `Format`: cadena UTF-8. Una plantilla de formato para el valor de la propiedad que define cómo se debe formatear el valor antes de enviarlo en las solicitudes de API. Use `{value}` como marcador de posición para el valor real de la propiedad (por ejemplo, `SSWS {value}`). ## Estructura de RestConfiguration Configuración que define la gestión de solicitud y respuesta HTTP, los puntos de conexión de validación y las configuraciones de entidad para las interacciones de la API de REST. **Campos** + `GlobalSourceConfiguration`: un objeto [SourceConfiguration](#aws-glue-api-catalog-connections-connections-type-SourceConfiguration). Parámetros de configuración global que se aplican a todas las solicitudes de la API de REST para este tipo de conexión, incluidos los métodos, rutas y parámetros de solicitud más comunes. + `ValidationEndpointConfiguration`: un objeto [SourceConfiguration](#aws-glue-api-catalog-connections-connections-type-SourceConfiguration). Configuración del punto de conexión utilizada para validar las credenciales de conexión y probar la conectividad durante la creación de la conexión. + `EntityConfigurations`: matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 con 1 byte de largo como mínimo y 128 bytes de largo como máximo, que coincide con [Custom string pattern #12](aws-glue-api-common.md#regex_12). Cada valor es un objeto [EntityConfiguration](#aws-glue-api-catalog-connections-connections-type-EntityConfiguration). Un mapa de configuraciones de entidades que define cómo interactuar con las diferentes entidades de datos disponibles a través de la API de REST, incluidos sus esquemas y patrones de acceso. ## Estructura de SourceConfiguration Configuración que define cómo realizar solicitudes a los puntos de conexión, incluidos los métodos de solicitud, las rutas, los parámetros y la gestión de las respuestas. **Campos** + `RequestMethod` – cadena UTF-8 (valores válidos: `GET` \| `POST`). El método HTTP que se usará para las solicitudes a este punto de conexión, como GET o POST. + `RequestPath` – cadena UTF-8, con 1 byte de largo como mínimo y 512 bytes de largo como máximo, que coincide con el [Custom string pattern #14](aws-glue-api-common.md#regex_14). La ruta URL del punto de conexión de REST, que puede incluir marcadores de posición de parámetros que se sustituirán por valores reales durante las solicitudes. + `RequestParameters`: matriz de objetos [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Configuración de los parámetros de solicitud que deben incluirse en las llamadas a la API, como los parámetros de consulta, los encabezados o el contenido del cuerpo. + `ResponseConfiguration`: un objeto [ResponseConfiguration](#aws-glue-api-catalog-connections-connections-type-ResponseConfiguration). Configuración que define cómo analizar y extraer datos de las respuestas de la API, incluida la gestión de respuestas correctas y errores. + `PaginationConfiguration`: un objeto [Configuración de paginación](#aws-glue-api-catalog-connections-connections-type-PaginationConfiguration). Configuración para gestionar las respuestas paginadas de la API de REST, que admite estrategias de paginación basadas en cursores y en desplazamiento. + `FilterConfiguration`: un objeto [FilterConfiguration](#aws-glue-api-catalog-connections-connections-type-FilterConfiguration). Configuración para aplicar la inserción de filtros en las solicitudes de la API de REST, que define cómo se traducen los predicados de filtro en parámetros de consulta o cadenas de filtro. ## Estructura de EntityConfiguration Configuración que define cómo interactuar con una entidad de datos específica a través de la API de REST, incluidos sus patrones de acceso y la definición del esquema. **Campos** + `SourceConfiguration`: un objeto [SourceConfiguration](#aws-glue-api-catalog-connections-connections-type-SourceConfiguration). La configuración de origen que define cómo realizar solicitudes para acceder a los datos de esta entidad a través de la API de REST. + `Schema`: matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8 de al menos 1 byte de largo. Cada valor es un objeto A [FieldDefinition](#aws-glue-api-catalog-connections-connections-type-FieldDefinition). La definición del esquema de esta entidad, incluidos los nombres de los campos, los tipos y otros metadatos que describen la estructura de los datos. ## Estructura de ResponseConfiguration Configuración que define cómo analizar las respuestas JSON a partir de las llamadas a la API de REST, incluidas las rutas a los datos de resultados y la información de errores. **Campos** + `ResultPath` – *Obligatorio:* cadena UTF-8, con 1 byte de largo como mínimo y 512 bytes de largo como máximo, que coincide con el [Custom string pattern #10](aws-glue-api-common.md#regex_10). La expresión de ruta JSON que identifica dónde se encuentran los datos de resultados reales dentro de la respuesta de la API. + `ErrorPath` – cadena UTF-8, con 1 byte de largo como mínimo y 512 bytes de largo como máximo, que coincide con el [Custom string pattern #10](aws-glue-api-common.md#regex_10). La expresión de ruta JSON que identifica dónde se encuentra la información de error en las respuestas de la API cuando las solicitudes fallan. ## Estructura de ResponseExtractionMapping Configuración que define cómo extraer valores del contenido o los encabezados de las respuestas HTTP para usarlos en solicitudes posteriores o en la asignación de parámetros. **Campos** + `ContentPath` – cadena UTF-8, con 1 byte de largo como mínimo y 512 bytes de largo como máximo, que coincide con el [Custom string pattern #10](aws-glue-api-common.md#regex_10). Expresión de ruta JSON que especifica cómo extraer un valor del contenido del cuerpo de la respuesta. + `HeaderKey` – 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 #15](aws-glue-api-common.md#regex_15). El nombre de un encabezado de respuesta HTTP del que se extrae el valor. ## Estructura de PaginationConfiguration Configuración que define cómo gestionar las respuestas paginadas de las API de REST y admite las diferentes estrategias de paginación utilizadas por varios servicios. **Campos** + `CursorConfiguration`: un objeto [CursorConfiguration](#aws-glue-api-catalog-connections-connections-type-CursorConfiguration). Configuración para la paginación basada en cursores, en la que la API proporciona un cursor o token para recuperar la siguiente página de resultados. + `OffsetConfiguration`: un objeto [OffsetConfiguration](#aws-glue-api-catalog-connections-connections-type-OffsetConfiguration). Configuración para la paginación basada en desplazamientos, en la que la API utiliza desplazamientos y límites numéricos para controlar los resultados que se devuelven. ## Estructura de CursorConfiguration Configuración de paginación basada en cursores que define cómo gestionar la paginación mediante tokens de cursor o identificadores de página siguiente. **Campos** + `NextPage` – *Obligatorio:* objeto [ExtractedParameter](#aws-glue-api-catalog-connections-connections-type-ExtractedParameter). El nombre del parámetro o la ruta JSON que contiene el cursor o el token para recuperar la siguiente página de resultados. + `LimitParameter`: un objeto [ExtractedParameter](#aws-glue-api-catalog-connections-connections-type-ExtractedParameter). El nombre del parámetro utilizado para especificar el número máximo de resultados que devolver por página. ## Estructura de OffsetConfiguration Configuración de paginación basada en desplazamientos que define cómo gestionar la paginación mediante desplazamientos y límites numéricos. **Campos** + `OffsetParameter` – *Obligatorio:* objeto [ExtractedParameter](#aws-glue-api-catalog-connections-connections-type-ExtractedParameter). El nombre del parámetro utilizado para especificar la posición inicial o el desplazamiento para recuperar los resultados. + `LimitParameter` – *Obligatorio:* objeto [ExtractedParameter](#aws-glue-api-catalog-connections-connections-type-ExtractedParameter). El nombre del parámetro utilizado para especificar el número máximo de resultados que devolver por página. ## Estructura de ExtractedParameter Configuración de extracción de parámetros que define cómo extraer y asignar los valores de las respuestas de la API a los parámetros de la solicitud. **Campos** + `Key` – 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 #15](aws-glue-api-common.md#regex_15). El nombre de la clave del parámetro que se utilizará en las solicitudes posteriores. + `DefaultValue` – cadena UTF-8, con 1 byte como mínimo o más de 1024 bytes de largo, que coincide con el [Custom string pattern #16](aws-glue-api-common.md#regex_16). El valor predeterminado que se usará si el parámetro no se puede extraer de la respuesta. + `PropertyLocation` – cadena UTF-8 (valores válidos: `HEADER` \| `BODY` \| `QUERY_PARAM` \| `PATH`). Especifica dónde debe colocarse este parámetro extraído en las solicitudes posteriores, como en los encabezados, los parámetros de la consulta o el cuerpo de la solicitud. + `Value`: un objeto [ResponseExtractionMapping](#aws-glue-api-catalog-connections-connections-type-ResponseExtractionMapping). La ruta de JSON o la asignación de extracción que define cómo extraer el valor del parámetro de las respuestas de la API. ## Estructura de FieldDefinition Define un campo en un esquema de entidad para los orígenes de datos del conector de REST y especifica el nombre del campo y el tipo de datos. **Campos** + `Name`: *obligatorio:* cadena UTF-8. Nombre del campo en el esquema de la entidad. + `FieldDataType` – *Obligatorio:* cadena UTF-8 (valores válidos: `INT` \| `SMALLINT` \| `BIGINT` \| `FLOAT` \| `LONG` \| `DATE` \| `BOOLEAN` \| `MAP` \| `ARRAY` \| `STRING` \| `TIMESTAMP` \| `DECIMAL` \| `BYTE` \| `SHORT` \| `DOUBLE` \| `STRUCT` \| `BINARY` \| `UNION`). Tipo de datos del campo. + `ResponseDateFormat`: cadena UTF-8. El patrón de formato para analizar los valores de fecha de las respuestas de la API. Obligatorio cuando la API utiliza un formato distinto de la ISO‑8601. Acepta patrones de `DateTimeFormatter` de Java (por ejemplo, `EEE, d MMM yyyy HH:mm:ss Z`), `EPOCH_SECONDS` para segundos de época de Unix o `EPOCH_MILLIS` para milisegundos de época de Unix. + `IsPartitionable`: booleano. Indica si este campo se puede utilizar para las consultas de creación de particiones en el origen de datos. + `IsNullable`: booleano. Indica si este campo puede contener valores nulos. + `IsQueryable`: booleano. Indica si este campo se puede utilizar en predicados de filtro al consultar datos. + `IsOrderable`: booleano. Indica si este campo se puede utilizar para ordenar los resultados. + `FilterOverrides`: un objeto [FilterOverrides](#aws-glue-api-catalog-connections-connections-type-FilterOverrides). Anulaciones por campo para el comportamiento del filtro, lo que permite personalizar la forma en que se aplican los filtros a este campo específico. ## Estructura de ConnectorOAuth2Properties Contenedor de configuración de OAuth2 que define las propiedades de autenticación y las configuraciones específicas del flujo para las conexiones basadas en OAuth2. **Campos** + `OAuth2GrantType` – *Obligatorio:* cadena UTF-8 (valores válidos: `CLIENT_CREDENTIALS` \| `JWT_BEARER` \| `AUTHORIZATION_CODE`). El tipo de concesión de OAuth2 que se usará para la autenticación, como CLIENT\_CREDENTIALS, JWT\_BEARER o AUTHORIZATION\_CODE. + `ClientCredentialsProperties`: un objeto [ClientCredentialsProperties](#aws-glue-api-catalog-connections-connections-type-ClientCredentialsProperties). Propiedades de configuración específicas del flujo del tipo de concesión de credenciales de cliente de OAuth2. + `JWTBearerProperties`: un objeto [JWTBearerProperties](#aws-glue-api-catalog-connections-connections-type-JWTBearerProperties). Propiedades de configuración específicas del flujo del tipo de concesión del portador de JWT de OAuth2. + `AuthorizationCodeProperties`: un objeto [ConnectorAuthorizationCodeProperties](#aws-glue-api-catalog-connections-connections-type-ConnectorAuthorizationCodeProperties). Propiedades de configuración específicas del flujo del tipo de concesión del código de autorización de OAuth2. ## Estructura de ClientCredentialsProperties Configuración de credenciales de cliente de OAuth2 que define las propiedades necesarias para el flujo del tipo de concesión de credenciales de cliente. **Campos** + `TokenUrl`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). URL del punto de conexión del token donde el cliente solicitará los tokens de acceso con las credenciales del cliente. + `RequestMethod` – cadena UTF-8 (valores válidos: `GET` \| `POST`). Método HTTP que se usará al realizar solicitudes de token; normalmente, POST. + `ContentType` – cadena UTF-8 (valores válidos: `APPLICATION_JSON` \| `URL_ENCODED`). Tipo de contenido que se usará para las solicitudes de token, como application/x-www-form-urlencoded o application/json. + `ClientId`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Identificador de cliente de OAuth2 proporcionado por el servidor de autorización. + `ClientSecret`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Secreto de cliente de OAuth2 proporcionado por el servidor de autorización. + `Scope`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Ámbito de OAuth2 que define el nivel de acceso solicitado para el flujo de credenciales del cliente. + `TokenUrlParameters`: matriz de objetos [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Parámetros adicionales para incluir en las solicitudes de URL de token como pares clave-valor. ## Estructura de JWTBearerProperties Configuración de token del portador de JWT que define las propiedades necesarias para el flujo del tipo de concesión de portador de JWT. **Campos** + `TokenUrl`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). URL del punto de conexión del token donde se intercambiará el token de portador de JWT por un token de acceso. + `RequestMethod` – cadena UTF-8 (valores válidos: `GET` \| `POST`). Método HTTP que se usará al realizar solicitudes de token de portador de JWT; normalmente, POST. + `ContentType` – cadena UTF-8 (valores válidos: `APPLICATION_JSON` \| `URL_ENCODED`). Tipo de contenido que se usará para las solicitudes de token de portador de JWT, como application/x-www-form-urlencoded o application/json. + `JwtToken`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Token JWT que se utilizará en el flujo de concesión del token de portador para la autenticación. + `TokenUrlParameters`: matriz de objetos [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Parámetros adicionales para incluir en las solicitudes de URL de token como pares clave-valor. ## Estructura de ConnectorAuthorizationCodeProperties Configuración del código de autorización de OAuth2 que define las propiedades necesarias para el flujo del tipo de concesión del código de autorización. **Campos** + `AuthorizationCodeUrl`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). URL del punto de conexión de autorización a la que se redirigirá a los usuarios para conceder la autorización. + `AuthorizationCode`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Código de autorización recibido del servidor de autorización después del consentimiento del usuario. + `RedirectUri`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). URI de redireccionamiento que debe coincidir con el URI registrado en el servidor de autorización. + `TokenUrl`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). URL del punto de conexión del token donde se intercambiará el código de autorización por un token de acceso. + `RequestMethod` – cadena UTF-8 (valores válidos: `GET` \| `POST`). Método HTTP que se usará al realizar solicitudes de intercambio de tokens; normalmente, POST. + `ContentType` – cadena UTF-8 (valores válidos: `APPLICATION_JSON` \| `URL_ENCODED`). Tipo de contenido que se usará para las solicitudes de intercambio de token, como application/x-www-form-urlencoded o application/json. + `ClientId`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Identificador de cliente de OAuth2 proporcionado por el servidor de autorización. + `ClientSecret`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Secreto de cliente de OAuth2 proporcionado por el servidor de autorización. + `Scope`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Ámbito de OAuth2 que define el nivel de acceso solicitado para el flujo de códigos de autorización. + `Prompt`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). El parámetro de petición de OAuth2 que controla el comportamiento del servidor de autorización durante la autenticación del usuario. + `TokenUrlParameters`: matriz de objetos [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Parámetros adicionales para incluir en las solicitudes de URL de token como pares clave-valor. ## Estructura de BasicAuthenticationProperties Configuración de autenticación básica que define las propiedades de nombre de usuario y contraseña para la autenticación básica HTTP. **Campos** + `Username`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Nombre de la propiedad del nombre de usuario que se usará para las credenciales de autenticación básica. + `Password`: un objeto [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Nombre de la propiedad de la contraseña que se usará para las credenciales de autenticación básica. ## Estructura de CustomAuthenticationProperties Configuración de autenticación personalizada que permite mecanismos de autenticación flexibles más allá de los flujos estándar de autenticación básica y de OAuth2. **Campos** + `AuthenticationParameters` *(obligatorio):* una matriz de objetos [ConnectorProperty](#aws-glue-api-catalog-connections-connections-type-ConnectorProperty). Un mapa de parámetros de la autenticación personalizada que definen el mecanismo de autenticación específico y las propiedades requeridas. ## Estructura de FilterConfiguration Configuración que define cómo se aplican los predicados de filtro a las solicitudes de la API de REST y admite estrategias de parámetros de consulta y cadenas de filtro. **Campos** + `FilterMode`: *obligatorio:* cadena UTF-8 (valores válidos: `QUERY_PARAMS` \| `FILTER_STRING`). Estrategia para aplicar filtros a las solicitudes. Use `QUERY_PARAMS` para pasar los filtros como parámetros de consulta individuales o `FILTER_STRING` para crear una cadena de expresión de filtro única. + `OperatorMappings`: matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8. Cada valor es una cadena UTF-8. Un mapa de los operadores de filtros lógicos con sus representaciones de cadenas específicas de la API. Las claves de operador compatibles son las siguientes: `EQUAL_TO`, `NOT_EQUAL_TO`, `LESS_THAN`, `GREATER_THAN`, `LESS_THAN_OR_EQUAL_TO`, `GREATER_THAN_OR_EQUAL_TO`, `CONTAINS`, `BETWEEN`, `AND` y `OR`. + `DateTimeFormat`: cadena UTF-8. El formato global de fecha y hora para las expresiones de filtro. Acepta patrones de `DateTimeFormatter` de Java (por ejemplo, `EEE, d MMM yyyy HH:mm:ss Z`), `EPOCH_SECONDS` para segundos de época de Unix o `EPOCH_MILLIS` para milisegundos de época de Unix. Si no se especifica, los valores se transmiten tal cual en formato ISO-8601. + `StripQuotes`: booleano. Indica si las comillas dobles circundantes deben eliminarse de los valores del filtro antes del procesamiento. + `BetweenConfiguration`: un objeto [BetweenConfiguration](#aws-glue-api-catalog-connections-connections-type-BetweenConfiguration). Configuración para gestionar las operaciones de filtrado de intervalos BETWEEN. + `FilterStringConfiguration`: un objeto [FilterStringConfiguration](#aws-glue-api-catalog-connections-connections-type-FilterStringConfiguration). Configuración para crear expresiones de filtro cuando `FilterMode` se establece en `FILTER_STRING`. ## Estructura de FilterOverrides Configuración que define las anulaciones por campo del comportamiento de los filtros, lo que permite que los campos individuales personalicen la forma en que se aplican las operaciones de filtrado. **Campos** + `FieldName`: cadena UTF-8. Una anulación del nombre del campo que se usará en las expresiones de filtro si es diferente del nombre del campo del esquema. + `OperatorMappings`: matriz de mapas de pares clave-valor. Cada clave es una cadena UTF-8. Cada valor es una cadena UTF-8. Un mapa de los operadores de filtros lógicos con sus representaciones de API específicas de cada campo, que anula las asignaciones de operadores globales. Las claves de operador compatibles son las siguientes: `EQUAL_TO`, `NOT_EQUAL_TO`, `LESS_THAN`, `GREATER_THAN`, `LESS_THAN_OR_EQUAL_TO`, `GREATER_THAN_OR_EQUAL_TO`, `CONTAINS`, `BETWEEN`, `AND` y `OR`. + `BetweenConfiguration`: un objeto [BetweenConfiguration](#aws-glue-api-catalog-connections-connections-type-BetweenConfiguration). Configuración específica del campo para gestionar las operaciones de filtrado de intervalos BETWEEN. + `DateTimeFormat`: cadena UTF-8. El formato global de fecha y hora para las expresiones de filtro de este campo, lo que anula el campo global `DateTimeFormat`. Acepta patrones de `DateTimeFormatter` de Java (por ejemplo, `EEE, d MMM yyyy HH:mm:ss Z`), `EPOCH_SECONDS` para segundos de época de Unix o `EPOCH_MILLIS` para milisegundos de época de Unix. ## Estructura de BetweenConfiguration Configuración que define cómo las operaciones del filtro de intervalos BETWEEN se traducen en parámetros de solicitud de la API de REST. **Campos** + `LowBoundKey`: cadena UTF-8. El nombre del parámetro utilizado para el valor límite inferior en una operación de filtro BETWEEN. + `HighBoundKey`: cadena UTF-8. El nombre del parámetro utilizado para el valor límite superior en una operación de filtro BETWEEN. + `Template`: cadena UTF-8. Una cadena de plantilla para crear la expresión del filtro BETWEEN. ## Estructura de FilterStringConfiguration Configuración para crear cadenas de expresiones de filtro cuando se utiliza el modo de filtro `FILTER_STRING`. **Campos** + `QueryParameterName`: *obligatorio:* cadena UTF-8. Nombre del parámetro de consulta utilizado para enviar la cadena de expresión de filtro creada en las solicitudes de API. + `QuoteStringValues`: booleano. Indica si los valores de cadena y fecha deben escribirse entre comillas en la expresión del filtro. + `QuoteCharacter`: cadena UTF-8. Carácter que se utiliza para entrecomillar valores cuando `QuoteStringValues` es “true”. Toma las comillas dobles como valor predeterminado si no se especifica.