Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Tipo di connessione API
L'API Connection Type descrive AWS Glue l'API per registrare, descrivere, eliminare ed elencare i tipi di connessione.
API di gestione delle connessioni
RegisterConnectionType azione (Python: register_connection_type)
Registra un tipo di connessione personalizzato in base alla configurazione fornita. AWS Glue Questa operazione consente ai clienti di configurare connettori personalizzati per qualsiasi origine dati con REST-based API, eliminando la necessità di creare connettori personalizzati Lambda .
Il tipo di connessione registrata memorizza i dettagli su come le richieste e le risposte vengono interpretate dalle fonti REST, incluse le proprietà di connessione, la configurazione dell'autenticazione e la configurazione REST con definizioni di entità. Una volta registrati, i clienti possono creare connessioni utilizzando questo tipo di connessione e utilizzarle allo stesso modo dei AWS Glue connettori supportati in modo nativo.
Supporta diversi tipi di autenticazione, tra cui le configurazioni Basic, OAuth2 (Client Credentials, JWT Bearer, Authorization Code) e Custom Auth.
Richiesta
-
ConnectionType— Obbligatoria: UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string patternIl nome del tipo di connessione. Deve contenere da 1 a 255 caratteri e deve essere preceduto da «REST-» per indicare che si tratta di un. REST-based connector
-
IntegrationType— Obbligatorio: UTF-8 stringa (valori validi:REST).Il tipo di integrazione per la connessione. Attualmente è supportato solo il protocollo «REST».
-
Description— UTF-8 stringa lunga non più di 1024 byte.Una descrizione del tipo di connessione. Può contenere fino a 2048 caratteri e fornisce dettagli sullo scopo e la funzionalità del tipo di connessione.
-
ConnectionProperties- obbligatorio: un oggetto ConnectionPropertiesConfiguration.Definisce l'URL di base e i parametri di richiesta aggiuntivi necessari durante la creazione della connessione per questo tipo di connessione.
-
ConnectorAuthenticationConfiguration- obbligatorio: un oggetto ConnectorAuthenticationConfiguration.Definisce i tipi di autenticazione supportati e le proprietà richieste per questo tipo di connessione, inclusi i metodi di autenticazione Basic, OAuth2 e Custom.
-
RestConfiguration- obbligatorio: un oggetto RestConfiguration.Definisce la configurazione della richiesta e della risposta HTTP, l'endpoint di convalida e le configurazioni delle entità per le interazioni con l'API REST.
-
Tags: una matrice di mappe con coppie chiave-valore, non superiore alle 50 coppie.Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.
Ogni valore è una UTF-8 stringa, lunga non più di 256 byte.
I tag assegnati al tipo di connessione.
Risposta
Contiene l'Amazon Resource Name (ARN) del tipo di connessione appena registrato.
-
ConnectionTypeArn— UTF-8 stringa, lunga non meno di 1 o più di 10240 byte, corrispondente a. Custom string pattern #47L'Amazon Resource Name (ARN) del tipo di connessione registrata. Questo identificatore univoco può essere utilizzato per fare riferimento al tipo di connessione in altre AWS Glue operazioni.
Errori
AlreadyExistsExceptionInvalidInputExceptionOperationTimeoutExceptionResourceNumberLimitExceededExceptionInternalServiceException
DeleteConnectionType azione (Python: delete_connection_type)
Elimina un tipo di connessione personalizzato in. AWS Glue
Il tipo di connessione deve esistere ed essere registrato prima di poter essere eliminato. Questa operazione supporta la pulizia delle risorse dei tipi di connessione e aiuta a mantenere una corretta gestione del ciclo di vita dei tipi di connessione personalizzati.
Richiesta
-
ConnectionType— Obbligatoria: UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string patternIl nome del tipo di connessione da eliminare. Deve fare riferimento a un tipo di connessione registrata esistente.
Risposta
Nessun parametro di risposta.
Errori
EntityNotFoundExceptionInvalidInputExceptionOperationTimeoutExceptionInternalServiceExceptionAccessDeniedException
DescribeConnectionType azione (Python: describe_connection_type)
L'API DescribeConnectionType fornisce tutti i dettagli delle opzioni supportate per un determinato tipo di connessione in AWS Glue. La risposta include dettagli di configurazione dell'autenticazione che mostrano i tipi e le proprietà di autenticazione supportati e i tipi di connessione personalizzati registrati RestConfiguration tramite. REST-based RegisterConnectionType
Vedi anche:ListConnectionTypes,RegisterConnectionType, DeleteConnectionType
Richiesta
-
ConnectionType— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string patternIl nome del tipo di connessione da descrivere.
Risposta
-
ConnectionType— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string patternIl nome del tipo di connessione.
-
Description— UTF-8 stringa, lunga non più di 1024 byte.Una descrizione del tipo di connessione.
-
Capabilities: un oggetto Funzionalità.I tipi di autenticazione supportati, i tipi di interfaccia dati (ambienti di calcolo) e le operazioni sui dati di. connector
-
ConnectionProperties: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa, lunga non meno di 1 o più di 128 byte.
Ogni valore è un oggetto Proprietà.
Proprietà di connessione comuni in tutti gli ambienti di calcolo.
-
ConnectionOptions: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.
Ogni valore è un oggetto Proprietà.
Restituisce proprietà che possono essere impostate durante la creazione di una connessione in
ConnectionInput.ConnectionProperties.ConnectionOptionsdefinisce i parametri che possono essere impostati in uno script ETL di Spark nella mappatura delle opzioni di connessione passata a un dataframe. -
AuthenticationConfiguration: un oggetto AuthConfiguration.Il tipo di autenticazione utilizzato per la connessione.
-
ComputeEnvironmentConfigurations: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.
Ogni valore è un oggetto ComputeEnvironmentConfiguration.
Gli ambienti di calcolo supportati dalla connessione.
-
PhysicalConnectionRequirements: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.
Ogni valore è un oggetto Proprietà.
Requisiti fisici per una connessione, come le specifiche del VPC, della sottorete e del gruppo di sicurezza.
-
AthenaConnectionProperties: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.
Ogni valore è un oggetto Proprietà.
Proprietà di connessione specifiche dell'ambiente di Athena elaborazione.
-
PythonConnectionProperties: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.
Ogni valore è un oggetto Proprietà.
Proprietà di connessione specifiche dell'ambiente di calcolo Python.
-
SparkConnectionProperties: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.
Ogni valore è un oggetto Proprietà.
Proprietà di connessione specifiche dell'ambiente di calcolo Spark.
-
RestConfiguration: un oggetto RestConfiguration.Configurazione di richieste e risposte HTTP, endpoint di convalida e configurazioni di entità per origini dati basate su REST.
Errori
ValidationExceptionInvalidInputExceptionInternalServiceException
ListConnectionTypes azione (Python: list_connection_types)
L'API ListConnectionTypes fornisce un meccanismo di individuazione in cui apprendere i tipi di connessione disponibili in AWS Glue. La risposta contiene un elenco di tipi di connessione con dettagli di alto livello su ciò che è supportato per ogni tipo di connessione, inclusi i tipi di connessione integrati e i tipi di connessione personalizzati registrati tramite. RegisterConnectionType I tipi di connessione elencati sono l'insieme di opzioni supportate per il valore ConnectionType nell'API CreateConnection.
Vedi anche:DescribeConnectionType,, RegisterConnectionType DeleteConnectionType
Richiesta
-
MaxResults: numero (intero), non inferiore a 1 o superiore a 1.000.Numero massimo di risultati da restituire.
-
NextToken— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte, corrispondente a. Custom string pattern #11Un token di continuazione, se si tratta di una chiamata di continuazione.
Risposta
-
ConnectionTypes: una matrice di oggetti ConnectionTypeBrief.Un elenco di oggetti
ConnectionTypeBriefcontenente brevi informazioni sui tipi di connessione supportati. -
NextToken— UTF-8 stringa, lunga non meno di 1 o più di 2048 byte, corrispondente a. Custom string pattern #11Un token di continuazione, se il segmento dell'elenco corrente non è l'ultimo.
Errori
InternalServiceException
ConnectionTypeBrief struttura
Brevi informazioni su un tipo di connessione supportato restituito dall'API ListConnectionTypes.
Campi
-
ConnectionType— UTF-8 stringa (valori validi:JDBCSFTPMONGODBKAFKA|NETWORK|MARKETPLACE|CUSTOM|SALESFORCE|VIEW_VALIDATION_REDSHIFT|VIEW_VALIDATION_ATHENAGOOGLEADS|GOOGLESHEETS|GOOGLEANALYTICS4|SERVICENOW|MARKETO|SAPODATA|ZENDESKJIRACLOUD|NETSUITEERP|HUBSPOT|FACEBOOKADS|INSTAGRAMADS|ZOHOCRMSALESFORCEPARDOT|SALESFORCEMARKETINGCLOUD|ADOBEANALYTICS|SLACK|LINKEDIN|MIXPANEL|ASANASTRIPE|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).Il nome del tipo di connessione.
-
DisplayName— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.Il nome leggibile dalle persone per il tipo di connessione visualizzato nella console AWS Glue .
-
Vendor— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.Il nome del fornitore o del provider che ha creato o gestisce questo tipo di connessione.
-
Description— UTF-8 stringa di lunghezza non superiore a 1024 byte.Una descrizione del tipo di connessione.
-
Categories— Una serie di stringhe. UTF-8Un elenco di categorie a cui appartiene questo tipo di connessione. Le categorie aiutano gli utenti a filtrare e trovare i tipi di connessione appropriati in base ai loro casi d'uso.
-
Capabilities: un oggetto Funzionalità.I tipi di autenticazione supportati, i tipi di interfaccia dati (ambienti di calcolo) e le operazioni sui dati di. connector
-
LogoUrl— UTF-8 stringa.L'URL del logo associato a un tipo di connessione.
-
ConnectionTypeVariants: una matrice di oggetti ConnectionTypeVariant.Un elenco di varianti disponibili per questo tipo di connessione. Varianti diverse possono fornire configurazioni specializzate per casi d'uso specifici o implementazioni dello stesso tipo di connessione generale.
ConnectionTypeVariant struttura
Rappresenta una variante di un tipo di connessione in AWS Glue. Le varianti del tipo di connessione forniscono configurazioni e comportamenti specifici per diverse implementazioni dello stesso tipo di connessione generale.
Campi
-
ConnectionTypeVariantName— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.L'identificatore univoco per la variante del tipo di connessione. Questo nome viene utilizzato internamente per identificare la variante specifica di un tipo di connessione.
-
DisplayName— UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.Il nome leggibile dall'uomo per la variante del tipo di connessione visualizzata nella console. AWS Glue
-
Description— UTF-8 stringa lunga non più di 1024 byte.Una descrizione dettagliata della variante del tipo di connessione, inclusi lo scopo, i casi d'uso e gli eventuali requisiti di configurazione specifici.
-
LogoUrl— stringa UTF-8 .L'URL del logo associato a una variante del tipo di connessione.
datatypes
Struttura di validazione
Definisce come viene eseguita una convalida su una proprietà di connessione.
Campi
-
ValidationType— Obbligatorio: UTF-8 stringa (valori validi:REGEX|RANGE).Il tipo di convalida da eseguire, ad esempio
REGEX. -
Patterns— Una serie di UTF-8 stringhe.Un elenco di modelli che si applicano alla convalida.
-
Description— UTF-8 Obbligatoria: stringa lunga non meno di 1 o più di 1024 byte.Una descrizione della validazione.
-
MaxLength: numero (intero).Lunghezza massima per la proprietà di connessione di una stringa.
-
Maximum: numero (intero).Un valore massimo quando si specifica un tipo di convalida
RANGE. -
Minimum: numero (intero).Un valore minimo quando si specifica un tipo di convalida
RANGE.
AuthConfiguration struttura
La configurazione di autenticazione per una connessione restituita dall'API DescribeConnectionType.
Campi
-
AuthenticationType- obbligatorio: un oggetto Proprietà.Il tipo di autenticazione da utilizzare per una connessione.
-
SecretArn: un oggetto Proprietà.Il nome della risorsa Amazon (ARN) per Secrets Manager.
-
OAuth2Properties: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.
Ogni valore è un oggetto Proprietà.
Una mappa di coppie chiave-valore per le proprietà OAuth2. Ogni valore è un oggetto
Property. -
BasicAuthenticationProperties: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.
Ogni valore è un oggetto Proprietà.
Una mappa di coppie chiave-valore per le proprietà OAuth2. Ogni valore è un oggetto
Property. -
CustomAuthenticationProperties: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.
Ogni valore è un oggetto Proprietà.
Una mappa di coppie chiave-valore per le proprietà di autenticazione personalizzate. Ogni valore è un oggetto
Property.
Struttura delle funzionalità
Specifica i tipi di autenticazione supportati restituiti dall'API DescribeConnectionType.
Campi
-
SupportedAuthenticationTypes— Obbligatorio: una serie di UTF-8 stringhe.Un elenco di tipi di autenticazione supportati.
-
SupportedDataOperations— Obbligatorio: una serie di UTF-8 stringhe.Un elenco delle operazioni dei dati supportate.
-
SupportedComputeEnvironments— Obbligatorio: una serie di UTF-8 stringhe.Un elenco di ambienti di calcolo supportati.
Struttura della proprietà
Un oggetto che definisce un tipo di connessione per un ambiente di calcolo.
Campi
-
Name— UTF-8 Obbligatoria: stringa lunga non meno di 1 o più di 128 byte.Il nome della proprietà.
-
Description— Obbligatoria: UTF-8 stringa lunga non più di 1024 byte.Una descrizione della proprietà.
-
Required- obbligatorio: booleano.Indica se la proprietà è obbligatoria.
-
DefaultValue— stringa UTF-8 .Il valore predefinito della proprietà.
-
PropertyTypes— Obbligatorio: una serie di UTF-8 stringhe.Descrive il tipo di proprietà.
-
AllowedValues: una matrice di oggetti AllowedValue.Un elenco di oggetti
AllowedValueche rappresentano i valori consentiti per la proprietà. -
DataOperationScopes— Una serie di UTF-8 stringhe.Indica quali operazioni sui dati sono applicabili alla proprietà.
-
KeyOverride— UTF-8 stringa.Un nome di chiave da utilizzare per l'invio di questa proprietà nelle richieste API, se diverso dal nome visualizzato.
-
PropertyLocation— UTF-8 stringa (valori validi:HEADER|BODY|QUERY_PARAM|PATH).Specifica dove questa proprietà deve essere inclusa nelle richieste REST, ad esempio nelle intestazioni, nei parametri delle query o nel corpo della richiesta.
AllowedValue struttura
Un oggetto che rappresenta un valore consentito per una proprietà.
Campi
-
Description— UTF-8 stringa lunga non più di 1024 byte.Una descrizione del valore consentito.
-
Value— UTF-8 Obbligatoria: stringa di lunghezza non inferiore a 1 o superiore a 128 byte.Il valore consentito per la proprietà.
ComputeEnvironmentConfiguration struttura
Un oggetto contenente la configurazione per un ambiente di calcolo (come Spark, Python o Athena) restituito dall'API DescribeConnectionType.
Campi
-
Name— UTF-8 Obbligatoria: stringa lunga non meno di 1 o più di 128 byte.Un nome per la configurazione dell'ambiente di calcolo.
-
Description— Obbligatoria: UTF-8 stringa lunga non più di 1024 byte.Una descrizione dell'ambiente di calcolo.
-
ComputeEnvironment— Obbligatorio: UTF-8 stringa (valori validi:SPARK|ATHENA|PYTHON).Tipo di ambiente di calcolo.
-
SupportedAuthenticationTypes— Obbligatorio: una serie di UTF-8 stringhe.I tipi di autenticazione supportati per l'ambiente di calcolo.
-
ConnectionOptions- obbligatorio: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.
Ogni valore è un oggetto Proprietà.
I parametri utilizzati come opzioni di connessione per l'ambiente di calcolo.
-
ConnectionPropertyNameOverrides- obbligatorio: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.
Ogni valore è una UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.
Il nome della proprietà di connessione ha la precedenza per l'ambiente di calcolo.
-
ConnectionOptionNameOverrides- obbligatorio: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa lunga non meno di 1 o più di 128 byte.
Ogni valore è una UTF-8 stringa di lunghezza non inferiore a 1 o superiore a 128 byte.
Il nome dell'opzione di connessione ha la precedenza per l'ambiente di calcolo.
-
ConnectionPropertiesRequiredOverrides— Obbligatorio: una matrice di UTF-8 stringhe.Le proprietà di connessione richieste come sostituzioni per l'ambiente di calcolo.
-
PhysicalConnectionPropertiesRequired: booleano.Indica se
PhysicalConnectionPropertiessono necessarie per l'ambiente di calcolo.
Tipi di dati personalizzati per i connettori
ConnectionPropertiesConfiguration struttura
Configurazione che definisce l'URL di base e i parametri di richiesta aggiuntivi necessari durante la creazione della connessione.
Campi
-
Url: un oggetto ConnectorProperty.L'URL dell'istanza di base per l'endpoint a cui si connetterà questo tipo di connessione.
-
AdditionalRequestParameters: una matrice di oggetti ConnectorProperty.Key-value coppie di parametri di richiesta aggiuntivi che potrebbero essere necessari durante la creazione della connessione, come le versioni delle API o le opzioni di configurazione specifiche del servizio.
ConnectorAuthenticationConfiguration struttura
Configurazione che definisce i tipi di autenticazione supportati e le proprietà richieste per il tipo di connessione.
Campi
-
AuthenticationTypes— Obbligatorio: una serie di UTF-8 stringhe.Un elenco di tipi di autenticazione supportati da questo tipo di connessione, ad esempio metodi di autenticazione Basic, OAuth2 o Custom.
ConnectorProperty struttura
Definisce una configurazione delle proprietà per i tipi di connessione, i valori predefiniti e dove la proprietà deve essere utilizzata nelle richieste.
Campi
-
Name— UTF-8 Obbligatoria: stringa lunga non meno di 1 o più di 128 byte.Il nome della proprietà.
-
KeyOverride— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. Custom string pattern #15Un nome chiave da utilizzare quando si invia questa proprietà nelle richieste API, se diverso dal nome visualizzato.
-
Required- obbligatorio: booleano.Indica se la proprietà è obbligatoria.
-
DefaultValue— UTF-8 stringa.Il valore predefinito della proprietà.
-
AllowedValues— Una serie di UTF-8 stringhe.Un elenco di oggetti
AllowedValueche rappresentano i valori consentiti per la proprietà. -
PropertyLocation— UTF-8 stringa (valori validi:HEADER| |BODYQUERY_PARAM|PATH).Specifica dove questa proprietà deve essere inclusa nelle richieste REST, ad esempio nelle intestazioni, nei parametri delle query o nel corpo della richiesta.
-
PropertyType— Obbligatorio: UTF-8 stringa (valori validi:USER_INPUT| |SECRET|READ_ONLYUNUSED|SECRET_OR_USER_INPUT).Il tipo di dati di questa proprietà
-
Format— UTF-8 stringa.Un modello di formato per il valore della proprietà che definisce come deve essere formattato il valore prima di inviarlo nelle richieste API.
{value}Utilizzalo come segnaposto per il valore effettivo della proprietà (ad esempio,).SSWS {value}
RestConfiguration struttura
Configurazione che definisce la gestione delle richieste e delle risposte HTTP, gli endpoint di convalida e le configurazioni delle entità per le interazioni con l'API REST.
Campi
-
GlobalSourceConfiguration: un oggetto SourceConfiguration.Impostazioni di configurazione globali che si applicano a tutte le richieste API REST per questo tipo di connessione, inclusi metodi, percorsi e parametri di richiesta comuni.
-
ValidationEndpointConfiguration: un oggetto SourceConfiguration.Configurazione per l'endpoint utilizzato per convalidare le credenziali di connessione e testare la connettività durante la creazione della connessione.
-
EntityConfigurations: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. Custom string pattern #12
Ogni valore è un oggetto EntityConfiguration.
Una mappa delle configurazioni delle entità che definisce come interagire con le diverse entità di dati disponibili tramite l'API REST, inclusi i relativi schemi e modelli di accesso.
SourceConfiguration struttura
Configurazione che definisce come effettuare richieste agli endpoint, inclusi metodi di richiesta, percorsi, parametri e gestione delle risposte.
Campi
-
RequestMethod— UTF-8 stringa (valori validi:GET|POST).Il metodo HTTP da utilizzare per le richieste a questo endpoint, ad esempio GET, POST.
-
RequestPath— UTF-8 stringa, lunga non meno di 1 o più di 512 byte, corrispondente a. Custom string pattern #14Il percorso URL per l'endpoint REST, che può includere segnaposti dei parametri che verranno sostituiti con valori effettivi durante le richieste.
-
RequestParameters: una matrice di oggetti ConnectorProperty.Configurazione per i parametri di richiesta che devono essere inclusi nelle chiamate API, ad esempio parametri di query, intestazioni o contenuto del corpo.
-
ResponseConfiguration: un oggetto ResponseConfiguration.Configurazione che definisce come analizzare ed estrarre i dati dalle risposte API, inclusa la gestione dei risultati e degli errori.
-
PaginationConfiguration: un oggetto PaginationConfiguration.Configurazione per la gestione delle risposte impaginate dall'API REST, che supporta strategie di impaginazione basate su cursore e offset.
-
FilterConfiguration: un oggetto FilterConfiguration.Configurazione per l'applicazione del filtro push down alle richieste dell'API REST, che definisce il modo in cui i predicati di filtro vengono tradotti in parametri di query o stringhe di filtro.
EntityConfiguration struttura
Configurazione che definisce come interagire con una specifica entità di dati tramite l'API REST, inclusi i relativi modelli di accesso e la definizione dello schema.
Campi
-
SourceConfiguration: un oggetto SourceConfiguration.La configurazione di origine che definisce come effettuare richieste di accesso ai dati di questa entità tramite l'API REST.
-
Schema: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa lunga almeno 1 byte.
Ogni valore è un oggetto FieldDefinition.
La definizione dello schema per questa entità, inclusi i nomi dei campi, i tipi e altri metadati che descrivono la struttura dei dati.
ResponseConfiguration struttura
Configurazione che definisce come analizzare le risposte JSON dalle chiamate API REST, inclusi i percorsi ai dati dei risultati e alle informazioni sugli errori.
Campi
-
ResultPath— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 512 byte, corrispondente a. Custom string pattern #10L'espressione del percorso JSON che identifica dove si trovano i dati dei risultati effettivi all'interno della risposta API.
-
ErrorPath— UTF-8 stringa, lunga non meno di 1 o più di 512 byte, corrispondente a. Custom string pattern #10L'espressione di percorso JSON che identifica dove si trovano le informazioni di errore all'interno delle risposte API in caso di esito negativo delle richieste.
ResponseExtractionMapping struttura
Configurazione che definisce come estrarre valori dal contenuto o dalle intestazioni delle risposte HTTP da utilizzare nelle richieste successive o nella mappatura dei parametri.
Campi
-
ContentPath— UTF-8 stringa, lunga non meno di 1 o più di 512 byte, corrispondente a. Custom string pattern #10Un'espressione di percorso JSON che specifica come estrarre un valore dal contenuto del corpo della risposta.
-
HeaderKey— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. Custom string pattern #15Il nome di un'intestazione di risposta HTTP da cui estrarre il valore.
PaginationConfiguration struttura
Configurazione che definisce come gestire le risposte impaginate dalle API REST, supportando diverse strategie di impaginazione utilizzate da vari servizi.
Campi
-
CursorConfiguration: un oggetto CursorConfiguration.Configurazione per l'impaginazione basata su cursore, in cui l'API fornisce un cursore o un token per recuperare la pagina successiva dei risultati.
-
OffsetConfiguration: un oggetto OffsetConfiguration.Configurazione per l'impaginazione basata sull'offset, in cui l'API utilizza offset e limiti numerici per controllare quali risultati vengono restituiti.
CursorConfiguration struttura
Cursor-based configurazione di impaginazione che definisce come gestire l'impaginazione utilizzando i token del cursore o gli identificatori della pagina successiva.
Campi
-
NextPage- obbligatorio: oggetto ExtractedParameter.Il nome del parametro o il percorso JSON che contiene il cursore o il token per recuperare la pagina successiva dei risultati.
-
LimitParameter: un oggetto ExtractedParameter.Il nome del parametro utilizzato per specificare il numero massimo di risultati da restituire per pagina.
OffsetConfiguration struttura
Offset-based configurazione di impaginazione che definisce come gestire l'impaginazione utilizzando offset e limiti numerici.
Campi
-
OffsetParameter- obbligatorio: oggetto ExtractedParameter.Il nome del parametro utilizzato per specificare la posizione iniziale o l'offset per il recupero dei risultati.
-
LimitParameter- obbligatorio: oggetto ExtractedParameter.Il nome del parametro utilizzato per specificare il numero massimo di risultati da restituire per pagina.
ExtractedParameter struttura
Configurazione di estrazione dei parametri che definisce come estrarre e mappare i valori dalle risposte API ai parametri della richiesta.
Campi
-
Key— UTF-8 stringa, lunga non meno di 1 o più di 128 byte, corrispondente a. Custom string pattern #15Il nome della chiave del parametro che verrà utilizzato nelle richieste successive.
-
DefaultValue— UTF-8 stringa, lunga non meno di 1 o più di 1024 byte, corrispondente a. Custom string pattern #16Il valore predefinito da utilizzare se il parametro non può essere estratto dalla risposta.
-
PropertyLocation— UTF-8 stringa (valori validi:HEADER| |BODYQUERY_PARAM|PATH).Specifica dove inserire questo parametro estratto nelle richieste successive, ad esempio nelle intestazioni, nei parametri delle query o nel corpo della richiesta.
-
Value: un oggetto ResponseExtractionMapping.Il percorso JSON o la mappatura di estrazione che definisce come estrarre il valore del parametro dalle risposte API.
FieldDefinition struttura
Definisce un campo in uno schema di entità per le origini dati del connettore REST, specificando il nome del campo e il tipo di dati.
Campi
-
Name— Obbligatorio: UTF-8 stringa.Il nome del campo nello schema dell'entità.
-
FieldDataType— Obbligatorio: UTF-8 stringa (valori validi:INTSMALLINTBIGINTFLOAT|LONG|DATE| |BOOLEAN|MAP|ARRAY|STRING|TIMESTAMP|DECIMAL|BYTE|SHORT|DOUBLE| |STRUCT|BINARY|UNION).Il tipo di dati del campo.
-
ResponseDateFormat— UTF-8 stringa.Il modello di formato per l'analisi dei valori di data dalle risposte API. Obbligatorio quando l'API utilizza un ISO-8601 formato diverso. Accetta
DateTimeFormatterpattern Java (ad esempioEEE, d MMM yyyy HH:mm:ss Z),EPOCH_SECONDSper secondi di epoca Unix oEPOCH_MILLISper millisecondi di epoca Unix. -
IsPartitionable: booleano.Indica se questo campo può essere utilizzato per partizionare le interrogazioni sull'origine dati.
-
IsNullable: booleano.Indica se questo campo può contenere valori nulli.
-
IsQueryable: booleano.Indica se questo campo può essere utilizzato nei predicati di filtro durante l'interrogazione dei dati.
-
IsOrderable: booleano.Indica se questo campo può essere utilizzato per ordinare i risultati.
-
FilterOverrides: un oggetto FilterOverrides.Per-field sostituisce il comportamento dei filtri, consentendo la personalizzazione del modo in cui i filtri vengono applicati a questo campo specifico.
ConnectorOAuth2Properties struttura
Contenitore di configurazione OAuth2 che definisce le proprietà di autenticazione e le configurazioni specifiche del flusso per le connessioni. OAuth2-based
Campi
-
OAuth2GrantType— Obbligatorio: UTF-8 stringa (valori validi: | |).CLIENT_CREDENTIALSJWT_BEARERAUTHORIZATION_CODEIl tipo di concessione OAuth2 da utilizzare per l'autenticazione, ad esempio CLIENT_CREDENTIALS, JWT_BEARER o AUTHORIZATION_CODE.
-
ClientCredentialsProperties: un oggetto ClientCredentialsProperties.Le proprietà di configurazione specifiche del flusso del tipo di concessione OAuth2 Client Credentials.
-
JWTBearerProperties: un oggetto JWTBearerProperties.Proprietà di configurazione specifiche del flusso del tipo di concessione OAuth2 JWT Bearer.
-
AuthorizationCodeProperties: un oggetto ConnectorAuthorizationCodeProperties.Proprietà di configurazione specifiche del flusso del tipo di concessione del codice di autorizzazione OAuth2.
ClientCredentialsProperties struttura
configurazione delle credenziali del client OAuth2 che definisce le proprietà necessarie per il flusso del tipo di concessione delle credenziali client.
Campi
-
TokenUrl: un oggetto ConnectorProperty.L'URL dell'endpoint del token in cui il client richiederà i token di accesso utilizzando le credenziali del client.
-
RequestMethod— UTF-8 stringa (valori validi:GET|).POSTIl metodo HTTP da utilizzare quando si effettuano richieste di token, in genere POST.
-
ContentType— UTF-8 stringa (valori validi:APPLICATION_JSON|URL_ENCODED).Il tipo di contenuto da utilizzare per le richieste di token, ad esempio application/x -www-form-urlencoded o. application/json
-
ClientId: un oggetto ConnectorProperty.L'identificatore del client OAuth2 fornito dal server di autorizzazione.
-
ClientSecret: un oggetto ConnectorProperty.Il segreto del client OAuth2 fornito dal server di autorizzazione.
-
Scope: un oggetto ConnectorProperty.L'ambito OAuth2 che definisce il livello di accesso richiesto per il flusso delle credenziali del client.
-
TokenUrlParameters: una matrice di oggetti ConnectorProperty.Parametri aggiuntivi da includere nelle richieste URL del token come coppie chiave-valore.
JWTBearerProperties struttura
configurazione del token JWT Bearer che definisce le proprietà necessarie per il flusso del tipo di concessione JWT Bearer.
Campi
-
TokenUrl: un oggetto ConnectorProperty.L'URL dell'endpoint del token in cui il token al portatore JWT verrà scambiato con un token di accesso.
-
RequestMethod— UTF-8 stringa (valori validi: |).GETPOSTIl metodo HTTP da utilizzare quando si effettuano richieste di token al portatore JWT, in genere POST.
-
ContentType— UTF-8 stringa (valori validi:APPLICATION_JSON|URL_ENCODED).Il tipo di contenuto da utilizzare per le richieste di token al portatore JWT, ad esempio application/x -www-form-urlencoded o. application/json
-
JwtToken: un oggetto ConnectorProperty.Il token JWT da utilizzare nel flusso di concessione del token al portatore per l'autenticazione.
-
TokenUrlParameters: una matrice di oggetti ConnectorProperty.Parametri aggiuntivi da includere nelle richieste URL del token come coppie chiave-valore.
ConnectorAuthorizationCodeProperties struttura
configurazione del codice di autorizzazione OAuth2 che definisce le proprietà necessarie per il flusso del tipo di concessione del codice di autorizzazione.
Campi
-
AuthorizationCodeUrl: un oggetto ConnectorProperty.L'URL dell'endpoint di autorizzazione a cui gli utenti verranno reindirizzati per concedere l'autorizzazione.
-
AuthorizationCode: un oggetto ConnectorProperty.Il codice di autorizzazione ricevuto dal server di autorizzazione dopo il consenso dell'utente.
-
RedirectUri: un oggetto ConnectorProperty.L'URI di reindirizzamento che deve corrispondere all'URI registrato presso il server di autorizzazione.
-
TokenUrl: un oggetto ConnectorProperty.L'URL dell'endpoint del token in cui il codice di autorizzazione verrà scambiato con un token di accesso.
-
RequestMethod— UTF-8 stringa (valori validi:GET|POST).Il metodo HTTP da utilizzare per effettuare richieste di scambio di token, in genere POST.
-
ContentType— UTF-8 stringa (valori validi:APPLICATION_JSON|URL_ENCODED).Il tipo di contenuto da utilizzare per le richieste di scambio di token, ad esempio application/x -www-form-urlencoded o. application/json
-
ClientId: un oggetto ConnectorProperty.L'identificatore del client OAuth2 fornito dal server di autorizzazione.
-
ClientSecret: un oggetto ConnectorProperty.Il segreto del client OAuth2 fornito dal server di autorizzazione.
-
Scope: un oggetto ConnectorProperty.L'ambito OAuth2 che definisce il livello di accesso richiesto per il flusso del codice di autorizzazione.
-
Prompt: un oggetto ConnectorProperty.Il parametro prompt OAuth2 che controlla il comportamento del server di autorizzazione durante l'autenticazione dell'utente.
-
TokenUrlParameters: una matrice di oggetti ConnectorProperty.Parametri aggiuntivi da includere nelle richieste URL del token come coppie chiave-valore.
BasicAuthenticationProperties struttura
Configurazione di autenticazione di base che definisce le proprietà del nome utente e della password per l'autenticazione HTTP Basic.
Campi
-
Username: un oggetto ConnectorProperty.Il nome della proprietà del nome utente da utilizzare per le credenziali di autenticazione di base.
-
Password: un oggetto ConnectorProperty.Il nome della proprietà della password da utilizzare per le credenziali di autenticazione di base.
CustomAuthenticationProperties struttura
Configurazione di autenticazione personalizzata che consente meccanismi di autenticazione flessibili oltre ai flussi Basic e OAuth2 standard.
Campi
-
AuthenticationParameters- obbligatorio: una matrice di oggetti ConnectorProperty.Una mappa di parametri di autenticazione personalizzati che definiscono il meccanismo di autenticazione specifico e le proprietà richieste.
FilterConfiguration struttura
Configurazione che definisce il modo in cui i predicati di filtro vengono applicati alle richieste dell'API REST, supportando sia le strategie relative ai parametri di query che alle stringhe di filtro.
Campi
-
FilterMode— Obbligatoria: UTF-8 stringa (valori validi:QUERY_PARAMS|FILTER_STRING).La strategia per applicare filtri alle richieste.
QUERY_PARAMSDa utilizzare per passare i filtri come singoli parametri di interrogazione oFILTER_STRINGper creare una singola stringa di espressione di filtro. -
OperatorMappings: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa.
Ogni valore è una UTF-8 stringa.
Una mappa degli operatori di filtro logico in base alle rispettive rappresentazioni di API-specific stringa. Le chiavi operatore supportate sono:
EQUAL_TONOT_EQUAL_TO,LESS_THAN,GREATER_THAN,LESS_THAN_OR_EQUAL_TO,GREATER_THAN_OR_EQUAL_TO,,CONTAINS,BETWEENAND, eOR. -
DateTimeFormat— UTF-8 stringa.Il formato globale di data e ora per le espressioni di filtro. Accetta
DateTimeFormatterpattern Java (ad esempioEEE, d MMM yyyy HH:mm:ss Z),EPOCH_SECONDSper secondi di epoca Unix oEPOCH_MILLISper millisecondi di epoca Unix. Se non specificato, i valori vengono passati così come sono nel formato. ISO-8601 -
StripQuotes: booleano.Indica se le virgolette doppie circostanti devono essere rimosse dai valori del filtro prima dell'elaborazione.
-
BetweenConfiguration: un oggetto BetweenConfiguration.Configurazione per la gestione delle operazioni di filtro BETWEEN Range.
-
FilterStringConfiguration: un oggetto FilterStringConfiguration.Configurazione per la costruzione di espressioni di filtro quando
FilterModeè impostata suFILTER_STRING.
FilterOverrides struttura
Configurazione che definisce le sostituzioni per campo per il comportamento dei filtri, consentendo ai singoli campi di personalizzare il modo in cui vengono applicate le operazioni di filtro.
Campi
-
FieldName— stringa. UTF-8Una sostituzione per il nome del campo da utilizzare nelle espressioni di filtro, se diverso dal nome del campo dello schema.
-
OperatorMappings: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa.
Ogni valore è una UTF-8 stringa.
Una mappa degli operatori di filtro logico rispetto alle rispettive rappresentazioni API specifiche del campo, che sovrascrive le mappature globali degli operatori. Le chiavi operatore supportate sono:
EQUAL_TO,,,,NOT_EQUAL_TO,LESS_THAN,,GREATER_THANLESS_THAN_OR_EQUAL_TO,GREATER_THAN_OR_EQUAL_TOe.CONTAINSBETWEENANDOR -
BetweenConfiguration: un oggetto BetweenConfiguration.Field-specific configurazione per la gestione delle operazioni di filtro BETWEEN Range.
-
DateTimeFormat— UTF-8 stringa.Il formato di data e ora per le espressioni di filtro in questo campo, che sostituisce quello globale
DateTimeFormat. AccettaDateTimeFormatterpattern Java (ad esempioEEE, d MMM yyyy HH:mm:ss Z),EPOCH_SECONDSper secondi di epoca Unix oEPOCH_MILLISper millisecondi di epoca Unix.
BetweenConfiguration struttura
Configurazione che definisce come le operazioni di filtro dell'intervallo BETWEEN vengono tradotte in parametri di richiesta dell'API REST.
Campi
-
LowBoundKey— UTF-8 stringa.Il nome del parametro utilizzato per il valore limite inferiore in un'operazione di filtro BETWEEN.
-
HighBoundKey— UTF-8 stringa.Il nome del parametro utilizzato per il valore limite superiore in un'operazione di filtro BETWEEN.
-
Template— UTF-8 stringa.Una stringa modello per la costruzione dell'espressione di filtro BETWEEN.
FilterStringConfiguration struttura
Configurazione per la costruzione di stringhe di espressione di filtro quando si utilizza la modalità FILTER_STRING filtro.
Campi
-
QueryParameterName— Obbligatorio: stringa UTF-8 .Il nome del parametro di query utilizzato per inviare la stringa di espressione del filtro costruita nelle richieste API.
-
QuoteStringValues: booleano.Indica se i valori di stringa e data devono essere racchiusi tra virgolette nell'espressione del filtro.
-
QuoteCharacter— UTF-8 stringa.Il carattere usato per citare i valori quando
QuoteStringValuesè vero. Il valore predefinito è costituito da virgolette doppie se non specificato.