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à.
API di connessione
L'API di AWS Glue connessione descrive i tipi di dati di connessione e l'API per la creazione, l'eliminazione, l'aggiornamento e l'elenco delle connessioni.
Tipi di dati
Struttura di connessione
Definisce una connessione a un'origine dati.
Campi
-
Name— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string patternIl nome della definizione di connessione.
-
Description: stringa di descrizione, non superiore a 2048 byte di lunghezza, corrispondente a URI address multi-line string pattern.La descrizione della connessione.
-
ConnectionType— UTF-8 stringa (valori validi:JDBCSFTP|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|WOOCOMMERCEINTERCOM|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 tipo di connessione. Attualmente, SFTP non è supportato.
-
MatchCriteria— Una serie di UTF-8 stringhe, non più di 10 stringhe.Un elenco di criteri che possono essere utilizzati nella selezione di questa connessione.
-
ConnectionProperties: una matrice di mappe con coppie chiave-valore, non superiore alle 100 coppie.Ogni chiave è una UTF-8 stringa (valori validi:
HOST|PORT|USERNAME="USER_NAME"|PASSWORD|ENCRYPTED_PASSWORD|JDBC_DRIVER_JAR_URI|JDBC_DRIVER_CLASS_NAME|JDBC_ENGINE|JDBC_ENGINE_VERSION|CONFIG_FILES|INSTANCE_ID|JDBC_CONNECTION_URL| |JDBC_ENFORCE_SSL|CUSTOM_JDBC_CERT|SKIP_CUSTOM_JDBC_CERT_VALIDATION|CUSTOM_JDBC_CERT_STRING|CONNECTION_URL|KAFKA_BOOTSTRAP_SERVERS|KAFKA_SSL_ENABLED|KAFKA_CUSTOM_CERT|KAFKA_SKIP_CUSTOM_CERT_VALIDATION|KAFKA_CLIENT_KEYSTORE|KAFKA_CLIENT_KEYSTORE_PASSWORD|KAFKA_CLIENT_KEY_PASSWORD|ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD|ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD| |KAFKA_SASL_MECHANISM|KAFKA_SASL_PLAIN_USERNAME|KAFKA_SASL_PLAIN_PASSWORD|ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD|KAFKA_SASL_SCRAM_USERNAME|KAFKA_SASL_SCRAM_PASSWORD|KAFKA_SASL_SCRAM_SECRETS_ARN|ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORDKAFKA_SASL_GSSAPI_KEYTABKAFKA_SASL_GSSAPI_KRB5_CONF|KAFKA_SASL_GSSAPI_SERVICE|KAFKA_SASL_GSSAPI_PRINCIPAL|SECRET_ID|CONNECTOR_URL|CONNECTOR_TYPE|CONNECTOR_CLASS_NAME| |ENDPOINT|ENDPOINT_TYPE|ROLE_ARN|REGION|WORKGROUP_NAME|CLUSTER_IDENTIFIER|DATABASE).Ogni valore è una stringa Value, non inferiore a 1 o superiore a 1.024 byte di lunghezza.
Queste coppie chiave-valore definiscono i parametri per la connessione quando si utilizza lo schema di connessione versione 1:
-
HOST: URI host: il nome di dominio completo (FQDN) o l'indirizzo IPv4 dell'host del database. -
PORT: il numero della porta, compreso tra 1024 e 65535, della porta su cui l'host del database ascolta le connessioni del database. -
USER_NAME: il nome sotto il quale accedere al database. La stringa del valore perUSER_NAMEèUSERNAME. -
PASSWORD: una password, se usata, per il nome utente. -
ENCRYPTED_PASSWORD: quando si abilita la protezione della password di connessione impostandoConnectionPasswordEncryptionnelle impostazioni di crittografia del catalogo dati, questo campo memorizza la password crittografata. -
JDBC_DRIVER_JAR_URI: il percorso Amazon Simple Storage Service (Amazon S3) del file JAR che contiene il driver JDBC da utilizzare. -
JDBC_DRIVER_CLASS_NAME: il nome classe del driver JDBC da utilizzare. -
JDBC_ENGINE: il nome del motore JDBC da utilizzare. -
JDBC_ENGINE_VERSION: la versione del motore JDBC da utilizzare. -
CONFIG_FILES: (Riservato per uso futuro). -
INSTANCE_ID: l'ID istanza da utilizzare. -
JDBC_CONNECTION_URL: l'URL per la connessione a un'origine dati JDBC. -
JDBC_ENFORCE_SSL: una stringa booleana (true, false) che fa distinzione tra maiuscole e minuscole che specifica se il protocollo Secure Sockets Layer (SSL) con nome host corrispondente viene applicato per la connessione JDBC al client. Il valore predefinito è false. -
CUSTOM_JDBC_CERT- Una posizione Amazon S3 che specifica il certificato principale del cliente. AWS Glue utilizza questo certificato radice per convalidare il certificato del cliente durante la connessione al database dei clienti. AWS Glue gestisce solo X.509 i certificati. Il certificato fornito deve essere DER-encoded e fornito in formato PEM con codifica Base64. -
SKIP_CUSTOM_JDBC_CERT_VALIDATION- Per impostazione predefinita, questo è.falseAWS Glue convalida l'algoritmo di firma e l'algoritmo Subject Public Key per il certificato del cliente. Gli unici algoritmi consentiti per l'algoritmo di firma sono SHA256withRSA, SHA384withRSA o SHA512withRSA. Per l'algoritmo della chiave pubblica oggetto, la lunghezza della chiave deve essere almeno 2048. Puoi impostare il valore di questa proprietà sutrueper ignorare la convalida di AWS Glue del certificato del cliente. -
CUSTOM_JDBC_CERT_STRING: una stringa di certificato JDBC personalizzata che viene utilizzata per la corrispondenza di dominio o per la corrispondenza nome distinto per evitare un attacco man-in-the-middle. Nel database Oracle, viene utilizzato comeSSL_SERVER_CERT_DN; in Microsoft SQL Server, viene utilizzato comehostNameInCertificate. -
CONNECTION_URL: l'URL per la connessione a un'origine dati generale (non JDBC). -
SECRET_ID: l'ID segreto utilizzato per il Secret Manager delle credenziali. -
CONNECTOR_URL: l'URL del connettore per una connessione MARKETPLACE o CUSTOM. -
CONNECTOR_TYPE: il tipo di connettore per una connessione MARKETPLACE o CUSTOM. -
CONNECTOR_CLASS_NAME: il nome di classe del connettore per una connessione MARKETPLACE o CUSTOM. -
KAFKA_BOOTSTRAP_SERVERS: un elenco separato da virgole di coppie host e porte che sono gli indirizzi dei broker Apache Kafka in un cluster Kafka a cui un client Kafka si connetterà e si avvierà. -
KAFKA_SSL_ENABLED: indica se abilitare o disabilitare SSL su una connessione Apache Kafka. Il valore di default è "true". -
KAFKA_CUSTOM_CERT: l'URL Amazon S3 per il file di certificazione CA privato (formato .pem). L'impostazione predefinita è una stringa vuota. -
KAFKA_SKIP_CUSTOM_CERT_VALIDATION- Se saltare o meno la convalida del file del certificato CA. AWS Glue convalida per tre algoritmi: SHA256withRSA, SHA384withRSA e SHA512withRSA. Il valore predefinito è "false". -
KAFKA_CLIENT_KEYSTORE: la posizione Amazon S3 del file keystore del client per l'autenticazione lato client Kafka (facoltativo). -
KAFKA_CLIENT_KEYSTORE_PASSWORD: la password per accedere al keystore fornito (facoltativo). -
KAFKA_CLIENT_KEY_PASSWORD: un keystore può essere costituito da più chiavi, quindi questa è la password per accedere alla chiave client da utilizzare con la chiave lato server Kafka (facoltativo). -
ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD- La versione crittografata della password del keystore del client Kafka (se l'utente ha selezionato l'impostazione di crittografia delle password). AWS Glue -
ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD- La versione crittografata della password della chiave del client Kafka (se l'utente ha selezionato l'impostazione di crittografia delle AWS Glue password). -
KAFKA_SASL_MECHANISM:"SCRAM-SHA-512","GSSAPI","AWS_MSK_IAM"o"PLAIN". Queste sono i due meccanismi SASLsupportati. -
KAFKA_SASL_PLAIN_USERNAME: un nome utente in testo normale utilizzato per l'autenticazione con il meccanismo “PLAIN”. -
KAFKA_SASL_PLAIN_PASSWORD: una password in testo normale utilizzata per l'autenticazione con il meccanismo “PLAIN”. -
ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD- La versione crittografata della password Kafka SASL PLAIN (se l'utente ha selezionato l'impostazione di crittografia delle AWS Glue password). -
KAFKA_SASL_SCRAM_USERNAME- Un nome utente in testo normale utilizzato per l'autenticazione con il meccanismo "». SCRAM-SHA-512 -
KAFKA_SASL_SCRAM_PASSWORD- Una password in testo normale utilizzata per l'autenticazione con il meccanismo "». SCRAM-SHA-512 -
ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD- La versione crittografata della password Kafka SASL SCRAM (se l'utente ha selezionato l'impostazione di crittografia delle password). AWS Glue -
KAFKA_SASL_SCRAM_SECRETS_ARN- Il nome della risorsa Amazon di un segreto in Secrets Manager. AWS -
KAFKA_SASL_GSSAPI_KEYTAB: la posizione S3 di un filekeytabKerberos. Un keytab memorizza le chiavi a lungo termine per uno o più principali. Per ulteriori informazioni, consulta la Documentazione di MIT Kerberos: keytab. -
KAFKA_SASL_GSSAPI_KRB5_CONF: la posizione S3 di un filekrb5.confKerberos. Un krb5.conf memorizza le informazioni di configurazione Kerberos, ad esempio la posizione del server KDC. Per ulteriori informazioni, consulta la Documentazione di MIT Kerberos: krb5.conf. -
KAFKA_SASL_GSSAPI_SERVICE: il nome del servizio Kerberos, come impostato consasl.kerberos.service.namenella Configurazione Kafka. -
KAFKA_SASL_GSSAPI_PRINCIPAL- Il nome del responsabile Kerberos utilizzato da. AWS Glue Per ulteriori informazioni, consulta la Documentazione di Kafka: configurazione dei broker Kafka. -
ROLE_ARN: il ruolo da utilizzare per l'esecuzione delle query. -
REGION- La AWS regione in cui verranno eseguite le interrogazioni. -
WORKGROUP_NAME: il nome di un gruppo di lavoro Amazon Redshift serverless o Amazon Athena in cui verranno eseguite le query. -
CLUSTER_IDENTIFIER: l'identificatore del cluster Amazon Redshift in cui verranno eseguite le query. -
DATABASE: il database Amazon Redshift a cui stai effettuando la connessione.
-
-
SparkProperties: 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, lunga non meno di 1 o più di 2048 byte.
Proprietà di connessione specifiche dell'ambiente di calcolo Spark.
-
AthenaProperties: 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, lunga non meno di 1 o più di 2048 byte.
Proprietà di connessione specifiche dell'ambiente di calcolo Athena.
-
PythonProperties: 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, lunga non meno di 1 o più di 2048 byte.
Proprietà di connessione specifiche dell'ambiente di calcolo Python.
-
PhysicalConnectionRequirements: un oggetto PhysicalConnectionRequirements.I requisiti di connessione fisici, come un cloud privato virtuale (VPC) e un
SecurityGroup, necessari per effettuare questa connessione. -
CreationTime: timestamp.Il timestamp dell'ora in cui è stata creata questa definizione della connessione.
-
LastUpdatedTime: timestamp.Il timestamp dell'ultima volta in cui è stata aggiornata la definizione della connessione.
-
LastUpdatedBy— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string patternL'utente, gruppo o ruolo che ha aggiornato per ultimo questa definizione di connessione.
-
Status— UTF-8 stringa (valori validi:READY|IN_PROGRESS|FAILED).Lo stato della connessione. Può essere
READY,IN_PROGRESSoFAILED. -
StatusReason— UTF-8 stringa, lunga non meno di 1 o più di 16384 byte.Il motivo dello stato della connessione.
-
LastConnectionValidationTime: timestamp.Un timestamp dell'ora in cui questa connessione è stata convalidata l'ultima volta.
-
AuthenticationConfiguration: un oggetto AuthenticationConfiguration.Le proprietà di autenticazione della connessione.
-
ConnectionSchemaVersion: numero (intero), non inferiore a 1 o superiore a 2.La versione dello schema di connessione per questa connessione. La versione 2 supporta proprietà per ambienti di calcolo specifici.
-
CompatibleComputeEnvironments— Una serie di stringhe. UTF-8Un elenco di ambienti di calcolo compatibili con la connessione.
ConnectionInput struttura
Una struttura utilizzata per specificare una connessione da creare o aggiornare.
Campi
-
Name— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string patternIl nome della connessione.
-
Description: stringa di descrizione, non superiore a 2048 byte di lunghezza, corrispondente a URI address multi-line string pattern.La descrizione della connessione.
-
ConnectionType— UTF-8 Obbligatoria: stringa (valori validi:JDBCSFTPMONGODB|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|SMARTSHEETDATADOG|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 tipo di connessione. Attualmente, sono supportati questi tipi:
-
JDBC: designa una connessione a un database tramite Java Database Connectivity (JDBC).JDBCLe connessioni utilizzano quanto segue ConnectionParameters.-
Obbligatorio: tutti (
HOST,PORT,JDBC_ENGINE) oJDBC_CONNECTION_URL. -
Obbligatorio: tutti (
USERNAME,PASSWORD) oSECRET_ID. -
Facoltativo:
JDBC_ENFORCE_SSL,CUSTOM_JDBC_CERT,CUSTOM_JDBC_CERT_STRING,SKIP_CUSTOM_JDBC_CERT_VALIDATION. Questi parametri vengono utilizzati per configurare SSL con JDBC.
-
-
KAFKA: indica una connessione a una piattaforma di streaming Apache Kafka.KAFKALe connessioni utilizzano quanto segue ConnectionParameters.-
Obbligatorio:
KAFKA_BOOTSTRAP_SERVERS. -
Facoltativo:
KAFKA_SSL_ENABLED,KAFKA_CUSTOM_CERT,KAFKA_SKIP_CUSTOM_CERT_VALIDATION. Questi parametri vengono utilizzati per configurare SSL conKAFKA. -
Facoltativo:
KAFKA_CLIENT_KEYSTORE,KAFKA_CLIENT_KEYSTORE_PASSWORD,KAFKA_CLIENT_KEY_PASSWORD,ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD,ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD. Questi parametri vengono utilizzati per impostare la configurazione del client TLS con SSL inKAFKA. -
Facoltativo:
KAFKA_SASL_MECHANISM. Può essere specificato comeSCRAM-SHA-512,GSSAPIoAWS_MSK_IAM. -
Facoltativo:
KAFKA_SASL_SCRAM_USERNAME,KAFKA_SASL_SCRAM_PASSWORD,ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD. Questi parametri vengono utilizzati per configurare SASL/SCRAM-SHA-512 l'autenticazione conKAFKA. -
Facoltativo:
KAFKA_SASL_GSSAPI_KEYTAB,KAFKA_SASL_GSSAPI_KRB5_CONF,KAFKA_SASL_GSSAPI_SERVICE,KAFKA_SASL_GSSAPI_PRINCIPAL. Questi parametri vengono utilizzati per configurare SASL/GSSAPI l'autenticazione conKAFKA.
-
-
MONGODB: designa una connessione a un database di documenti MongoDB.MONGODBLe connessioni utilizzano quanto segue ConnectionParameters.-
Obbligatorio:
CONNECTION_URL. -
Obbligatorio: tutti (
USERNAME,PASSWORD) oSECRET_ID.
-
-
VIEW_VALIDATION_REDSHIFT: indica una connessione utilizzata per la convalida della visualizzazione da parte di Amazon Redshift. -
VIEW_VALIDATION_ATHENA: indica una connessione utilizzata per la convalida della visualizzazione da parte di Amazon Athena. -
NETWORK: designa una connessione di rete a un'origine dati all'interno di un ambiente Amazon Virtual Private Cloud (Amazon VPC).NETWORKLe connessioni non richiedono ConnectionParameters. Fornisci invece un PhysicalConnectionRequirements. -
MARKETPLACE- Utilizza le impostazioni di configurazione contenute in un connettore acquistato AWS Marketplace per leggere e scrivere su archivi dati che non sono supportati in modo nativo da AWS Glue.MARKETPLACELe connessioni utilizzano quanto segue ConnectionParameters.-
Obbligatorio:
CONNECTOR_TYPE,CONNECTOR_URL,CONNECTOR_CLASS_NAME,CONNECTION_URL. -
Obbligatorio per le connessioni
JDBCCONNECTOR_TYPE: tutti (USERNAME,PASSWORD) oSECRET_ID.
-
-
CUSTOM: utilizza le impostazioni di configurazione contenute in un connettore per leggere e scrivere in archivi dati non supportati nativamente da AWS Glue.
Per ulteriori informazioni sui parametri di connessione necessari per un particolare connettore, vedere la documentazione relativa al connettore in Aggiungere una AWS Glue connessione nella Guida per l' AWS Glue utente.
SFTPnon è supportato.Per ulteriori informazioni su come ConnectionProperties vengono utilizzati gli opzionali per configurare le funzionalità in AWS Glue, consulta le proprietà di AWS Glue connessione.
Per ulteriori informazioni su come ConnectionProperties vengono utilizzati gli opzionali per configurare le funzionalità in AWS Glue Studio, consulta Utilizzo di connettori e connessioni.
-
-
MatchCriteria— Una serie di UTF-8 stringhe, non più di 10 stringhe.Un elenco di criteri che possono essere utilizzati nella selezione di questa connessione.
-
ConnectionProperties: obbligatorio: una matrice di mappe di coppie chiave-valore, non superiore a 100 coppie.Ogni chiave è una UTF-8 stringa (valori validi:
HOST|PORT|USERNAME="USER_NAME"|PASSWORD|ENCRYPTED_PASSWORD|JDBC_DRIVER_JAR_URI|JDBC_DRIVER_CLASS_NAME|JDBC_ENGINE|JDBC_ENGINE_VERSION|CONFIG_FILES|INSTANCE_ID|JDBC_CONNECTION_URL| |JDBC_ENFORCE_SSL|CUSTOM_JDBC_CERT|SKIP_CUSTOM_JDBC_CERT_VALIDATION|CUSTOM_JDBC_CERT_STRING|CONNECTION_URL|KAFKA_BOOTSTRAP_SERVERS|KAFKA_SSL_ENABLED|KAFKA_CUSTOM_CERT|KAFKA_SKIP_CUSTOM_CERT_VALIDATION|KAFKA_CLIENT_KEYSTORE|KAFKA_CLIENT_KEYSTORE_PASSWORD|KAFKA_CLIENT_KEY_PASSWORD|ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD|ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD| |KAFKA_SASL_MECHANISM|KAFKA_SASL_PLAIN_USERNAME|KAFKA_SASL_PLAIN_PASSWORD|ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD|KAFKA_SASL_SCRAM_USERNAME|KAFKA_SASL_SCRAM_PASSWORD|KAFKA_SASL_SCRAM_SECRETS_ARN|ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORDKAFKA_SASL_GSSAPI_KEYTABKAFKA_SASL_GSSAPI_KRB5_CONF|KAFKA_SASL_GSSAPI_SERVICE|KAFKA_SASL_GSSAPI_PRINCIPAL|SECRET_ID|CONNECTOR_URL|CONNECTOR_TYPE|CONNECTOR_CLASS_NAME| |ENDPOINT|ENDPOINT_TYPE|ROLE_ARN|REGION|WORKGROUP_NAME|CLUSTER_IDENTIFIER|DATABASE).Ogni valore è una stringa Value, non inferiore a 1 o superiore a 1.024 byte di lunghezza.
Queste coppie chiave-valore definiscono i parametri per la connessione.
-
SparkProperties: 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, lunga non meno di 1 o più di 2048 byte.
Proprietà di connessione specifiche dell'ambiente di calcolo Spark.
-
AthenaProperties: 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, lunga non meno di 1 o più di 2048 byte.
Proprietà di connessione specifiche dell'ambiente di calcolo Athena.
-
PythonProperties: 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, lunga non meno di 1 o più di 2048 byte.
Proprietà di connessione specifiche dell'ambiente di calcolo Python.
-
PhysicalConnectionRequirements: un oggetto PhysicalConnectionRequirements.I requisiti di connessione fisici, come un cloud privato virtuale (VPC) e un
SecurityGroup, necessari per effettuare correttamente questa connessione. -
AuthenticationConfiguration: un oggetto AuthenticationConfigurationInput.Le proprietà di autenticazione della connessione.
-
ValidateCredentials: booleano.Una spunta per convalidare le credenziali durante la creazione della connessione. Il valore predefinito è true.
-
ValidateForComputeEnvironments— Una serie di stringhe. UTF-8Gli ambienti di calcolo in cui vengono convalidate le proprietà di connessione specificate.
TestConnectionInput struttura
Una struttura utilizzata per specificare il test di una connessione a un servizio.
Campi
-
ConnectionType— UTF-8 Obbligatoria: stringa (valori validi:JDBCSFTPMONGODBKAFKA| |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).Il tipo di connessione da testare. Questa operazione è disponibile solo per i tipi di connessione
JDBCoSALESFORCE. -
ConnectionProperties: obbligatorio: una matrice di mappe di coppie chiave-valore, non superiore a 100 coppie.Ogni chiave è una UTF-8 stringa (valori validi:
HOST|PORT|USERNAME="USER_NAME"|PASSWORD| |ENCRYPTED_PASSWORD|JDBC_DRIVER_JAR_URI|JDBC_DRIVER_CLASS_NAME|JDBC_ENGINE|JDBC_ENGINE_VERSION|CONFIG_FILES|INSTANCE_ID|JDBC_CONNECTION_URL|JDBC_ENFORCE_SSL| |CUSTOM_JDBC_CERT|SKIP_CUSTOM_JDBC_CERT_VALIDATION|CUSTOM_JDBC_CERT_STRING|CONNECTION_URL|KAFKA_BOOTSTRAP_SERVERS|KAFKA_SSL_ENABLED|KAFKA_CUSTOM_CERT|KAFKA_SKIP_CUSTOM_CERT_VALIDATION|KAFKA_CLIENT_KEYSTORE| |KAFKA_CLIENT_KEYSTORE_PASSWORD|KAFKA_CLIENT_KEY_PASSWORD|ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD|ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD|KAFKA_SASL_MECHANISM|KAFKA_SASL_PLAIN_USERNAME|KAFKA_SASL_PLAIN_PASSWORD|ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD|KAFKA_SASL_SCRAM_USERNAME| |KAFKA_SASL_SCRAM_PASSWORD|KAFKA_SASL_SCRAM_SECRETS_ARN|ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD|KAFKA_SASL_GSSAPI_KEYTAB|KAFKA_SASL_GSSAPI_KRB5_CONF|KAFKA_SASL_GSSAPI_SERVICE|KAFKA_SASL_GSSAPI_PRINCIPAL|SECRET_ID|CONNECTOR_URL|CONNECTOR_TYPE|CONNECTOR_CLASS_NAME| |ENDPOINT|ENDPOINT_TYPE|ROLE_ARN|REGION|WORKGROUP_NAME|CLUSTER_IDENTIFIER|DATABASE).Ogni valore è una stringa Value, non inferiore a 1 o superiore a 1.024 byte di lunghezza.
Le coppie chiave-valore che definiscono i parametri per la connessione.
Le connessioni JDBC utilizzano le seguenti proprietà di connessione:
-
Obbligatorio: tutti (
HOST,PORT,JDBC_ENGINE) oJDBC_CONNECTION_URL. -
Obbligatorio: tutti (
USERNAME,PASSWORD) oSECRET_ID. -
Facoltativo:
JDBC_ENFORCE_SSL,CUSTOM_JDBC_CERT,CUSTOM_JDBC_CERT_STRING,SKIP_CUSTOM_JDBC_CERT_VALIDATION. Questi parametri vengono utilizzati per configurare SSL con JDBC.
Le connessioni SALESFORCE richiedono la configurazione del membro
AuthenticationConfiguration. -
-
AuthenticationConfiguration: un oggetto AuthenticationConfigurationInput.Una struttura contenente la configurazione di autenticazione nella TestConnection richiesta. Obbligatoria per una connessione a Salesforce tramite l'autenticazione OAuth.
PhysicalConnectionRequirements struttura
L'app client OAuth in GetConnection risposta.
Campi
-
SubnetId— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string patternL'ID della sottorete utilizzato dalla connessione.
-
SecurityGroupIdList— Una matrice di UTF-8 stringhe, non più di 50 stringhe.L'elenco di ID del gruppo di sicurezza utilizzato dalla connessione.
-
AvailabilityZone— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string patternLa zona di disponibilità della connessione.
GetConnectionsFilter struttura
Filtra le definizioni di connessione restituite dall'operazione API GetConnections.
Campi
-
MatchCriteria— Una serie di UTF-8 stringhe, non più di 10 stringhe.Una stringa di criteri che deve corrispondere ai criteri registrati nella definizione di connessione affinché venga restituita quella definizione di connessione.
-
ConnectionType— UTF-8 stringa (valori validi: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|DATADOGWOOCOMMERCEINTERCOM|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 tipo di connessioni da restituire. Attualmente, SFTP non è supportato.
-
ConnectionSchemaVersion: numero (intero), non inferiore a 1 o superiore a 2.Indica se la connessione è stata creata con la versione 1 o 2 dello schema.
AuthenticationConfiguration struttura
Una struttura contenente la configurazione dell'autenticazione.
Campi
-
AuthenticationType— UTF-8 stringa (valori validi:BASIC|OAUTH2|CUSTOM|IAM).Una struttura contenente la configurazione dell'autenticazione.
-
SecretArn— UTF-8 stringa, corrispondente aCustom string pattern #32.L'ARN del gestore segreto per archiviare le credenziali.
-
KmsKeyArn— UTF-8 stringa, corrispondente aCustom string pattern #39.Il nome della risorsa Amazon (ARN) della chiave KMS utilizzato per crittografare le informazioni di autenticazione sensibili. Questa chiave viene utilizzata per proteggere le credenziali e altri dati sensibili archiviati nella configurazione di autenticazione.
-
OAuth2Properties: un oggetto OAuth2Properties.Le proprietà per l'autenticazione OAuth2.
AuthenticationConfigurationInput struttura
Una struttura contenente la configurazione di autenticazione nella CreateConnection richiesta.
Campi
-
AuthenticationType— UTF-8 stringa (valori validi:BASIC|OAUTH2|CUSTOM|IAM).Una struttura contenente la configurazione di autenticazione nella CreateConnection richiesta.
-
OAuth2Properties: un oggetto OAuth2PropertiesInput.Le proprietà per l'autenticazione OAuth2 nella CreateConnection richiesta.
-
SecretArn— UTF-8 stringa, corrispondente a. Custom string pattern #32L'ARN del gestore segreto per memorizzare le credenziali nella CreateConnection richiesta.
-
KmsKeyArn— UTF-8 stringa, corrispondente a. Custom string pattern #39L'ARN della chiave KMS da utilizzare per crittografare la connessione. Viene preso solo come input nella richiesta e archiviato in Secrets Manager.
-
BasicAuthenticationCredentials: un oggetto BasicAuthenticationCredentials.Le credenziali utilizzate quando il tipo di autenticazione è di base.
-
CustomAuthenticationCredentials: 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, lunga non meno di 1 o più di 2048 byte.
Le credenziali utilizzate quando il tipo di autenticazione è personalizzato.
OAuth2Properties struttura
Una struttura contenente proprietà per l'autenticazione OAuth2.
Campi
-
OAuth2GrantType— UTF-8 stringa (valori validi:AUTHORIZATION_CODE|CLIENT_CREDENTIALS|JWT_BEARER).Il tipo di concessione OAuth2. Ad esempio,
AUTHORIZATION_CODE,JWT_BEARERoCLIENT_CREDENTIALS. -
OAuth2ClientApplication: un oggetto OAuth2ClientApplication.Il tipo di applicazione client. Ad esempio, AWS_MANAGED o USER_MANAGED.
-
TokenUrl— UTF-8 stringa, lunga non più di 256 byte, corrispondente a. Custom string pattern #37L'URL del server di autenticazione del provider, per scambiare un codice di autorizzazione per un token di accesso.
-
TokenUrlParametersMap: 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, lunga non meno di 1 o più di 512 byte.
Una mappa dei parametri che vengono aggiunti alla richiesta del token
GET.
OAuth2PropertiesInput struttura
Una struttura contenente le proprietà per OAuth2 nella CreateConnection richiesta.
Campi
-
OAuth2GrantType— UTF-8 stringa (valori validi:AUTHORIZATION_CODE|CLIENT_CREDENTIALS|JWT_BEARER).Il tipo di concessione OAuth2 nella CreateConnection richiesta. Ad esempio,
AUTHORIZATION_CODE,JWT_BEARERoCLIENT_CREDENTIALS. -
OAuth2ClientApplication: un oggetto OAuth2ClientApplication.Il tipo di applicazione client nella CreateConnection richiesta. Ad esempio
AWS_MANAGEDoUSER_MANAGED. -
TokenUrl— UTF-8 stringa, lunga non più di 256 byte, corrispondente a. Custom string pattern #37L'URL del server di autenticazione del provider, per scambiare un codice di autorizzazione per un token di accesso.
-
TokenUrlParametersMap: 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, lunga non meno di 1 o più di 512 byte.
Una mappa dei parametri che vengono aggiunti alla richiesta del token
GET. -
AuthorizationCodeProperties: un oggetto AuthorizationCodeProperties.L'insieme di proprietà richieste per il tipo di concessione OAuth2
AUTHORIZATION_CODE. -
OAuth2Credentials: un oggetto OAuth2Credentials.Le credenziali utilizzate quando il tipo di autenticazione è OAuth2.
OAuth2ClientApplication struttura
L'app client OAuth2 utilizzata per la connessione.
Campi
-
UserManagedClientApplicationClientId— UTF-8 stringa, lunga non più di 2048 byte, corrispondente a. Custom string pattern #33L'applicazione client ClientID, se è. ClientAppType
USER_MANAGED -
AWSManagedClientApplicationReference— UTF-8 stringa, lunga non più di 2048 byte, corrispondente a. Custom string pattern #33Il riferimento all'app SaaS-side client gestita AWS .
AuthorizationCodeProperties struttura
L'insieme di proprietà richieste per il flusso di lavoro del tipo di concessione OAuth2 AUTHORIZATION_CODE.
Campi
-
AuthorizationCode— UTF-8 stringa, lunga non meno di 1 o più di 4096 byte, corrispondente a. Custom string pattern #33Un codice di autorizzazione da utilizzare nella terza fase del flusso di lavoro di concessione
AUTHORIZATION_CODE. Si tratta di un codice monouso che diventa non valido una volta scambiato con un token di accesso, quindi è accettabile avere tale valore come parametro di richiesta. -
RedirectUri— UTF-8 stringa, lunga non più di 512 byte, corrispondente a. Custom string pattern #38L'URI di reindirizzamento a cui l'utente viene reindirizzato dal server di autorizzazione quando emette un codice di autorizzazione. L'URI viene successivamente utilizzato quando il codice di autorizzazione viene scambiato per un token di accesso.
BasicAuthenticationCredentials struttura
Per assegnare credenziali di autenticazione di base quando non si fornisce un valore SecretArn.
Campi
-
Username— UTF-8 stringa, lunga non più di 512 byte, corrispondente a. Custom string pattern #33Il nome utente da connettere all'origine dati.
-
Password— UTF-8 stringa, lunga non più di 512 byte, corrispondente a. Custom string pattern #34La password per la connessione all'origine dati.
OAuth2Credentials struttura
Le credenziali utilizzate quando il tipo di autenticazione è OAuth2.
Campi
-
UserManagedClientApplicationClientSecret— UTF-8 stringa, lunga non più di 512 byte, corrispondente a. Custom string pattern #35Il segreto del client dell'applicazione client se è gestita dall'utente.
-
AccessToken— UTF-8 stringa, lunga non più di 4096 byte, corrispondente a. Custom string pattern #35Il token di accesso utilizzato quando il tipo di autenticazione è OAuth2.
-
RefreshToken— UTF-8 stringa, lunga non più di 4096 byte, corrispondente a. Custom string pattern #35Il token di aggiornamento utilizzato quando il tipo di autenticazione è OAuth2.
-
JwtToken— UTF-8 stringa, lunga non più di 8000 byte, corrispondente a. Custom string pattern #36Il JWT (JSON Web Token) utilizzato quando il tipo di autenticazione è OAuth2.
Operazioni
CreateConnection azione (Python: create_connection)
Crea una definizione di connessione nel catalogo dati.
Le connessioni utilizzate per creare risorse federate richiedono l'autorizzazione IAM glue:PassConnection.
Richiesta
-
CatalogId: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.L'ID del catalogo dati in cui creare la connessione. Se non ne viene fornito nessuno, l'ID dell' AWS account viene utilizzato per impostazione predefinita.
-
ConnectionInput- obbligatorio: un oggetto ConnectionInput.Un oggetto
ConnectionInputche definisce la connessione da creare. -
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 alla connessione.
Risposta
-
CreateConnectionStatus— UTF-8 stringa (valori validi:READY|IN_PROGRESS|FAILED).Lo stato della richiesta di creazione della connessione. La richiesta può impiegare del tempo per determinati tipi di autenticazione, ad esempio quando si crea una connessione OAuth con scambio di token tramite VPC.
Errori
AlreadyExistsExceptionInvalidInputExceptionOperationTimeoutExceptionResourceNumberLimitExceededExceptionGlueEncryptionException
DeleteConnection azione (Python: delete_connection)
Elimina una connessione dal catalogo dati.
Richiesta
-
CatalogId: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.L'ID del catalogo dati in cui risiede la connessione. Se non ne viene fornito nessuno, l'ID dell' AWS account viene utilizzato per impostazione predefinita.
-
ConnectionName— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.Nome della connessione da eliminare.
Risposta
Nessun parametro di risposta.
Errori
EntityNotFoundExceptionOperationTimeoutException
GetConnection azione (Python: get_connection)
Recupera una definizione di connessione dal catalogo dati.
Richiesta
-
CatalogId: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.L'ID del catalogo dati in cui risiede la connessione. Se non ne viene fornito nessuno, l'ID dell' AWS account viene utilizzato per impostazione predefinita.
-
Name— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.Il nome della definizione di connessione da recuperare.
-
HidePassword: booleano.Consente di recuperare i metadati di connessione senza restituire la password. Ad esempio, la AWS Glue console utilizza questo flag per recuperare la connessione e non visualizza la password. Imposta questo parametro quando il chiamante potrebbe non avere il permesso di usare la AWS KMS chiave per decrittografare la password, ma ha il permesso di accedere al resto delle proprietà di connessione.
-
ApplyOverrideForComputeEnvironment— UTF-8 stringa (valori validi:SPARK| |ATHENA).PYTHONPer le connessioni che possono essere utilizzate in più servizi, specifica le proprietà di restituzione per l'ambiente di calcolo specificato.
Risposta
-
Connection: un oggetto Connessione.La definizione di connessione richiesta.
Errori
EntityNotFoundExceptionOperationTimeoutExceptionInvalidInputExceptionGlueEncryptionException
GetConnections azione (Python: get_connections)
Recupera un elenco di definizioni di connessione dal catalogo dati.
Richiesta
-
CatalogId: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.L'ID del catalogo dati in cui risiedono le connessioni. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID AWS dell'account.
-
Filter: un oggetto GetConnectionsFilter.Un filtro che controlla quali connessioni vengono restituite.
-
HidePassword: booleano.Consente di recuperare i metadati di connessione senza restituire la password. Ad esempio, la AWS Glue console utilizza questo flag per recuperare la connessione e non visualizza la password. Imposta questo parametro quando il chiamante potrebbe non avere il permesso di usare la AWS KMS chiave per decrittografare la password, ma ha il permesso di accedere al resto delle proprietà di connessione.
-
NextToken— stringa. UTF-8Un token di continuazione, se si tratta di una chiamata di continuazione.
-
MaxResults: numero (intero), non inferiore a 1 o superiore a 1.000.Il numero massimo di connessioni da restituire in una risposta.
Risposta
-
ConnectionList: una matrice di oggetti Connessione.Un elenco di definizioni di connessione richieste.
-
NextToken— UTF-8 corda.Un token di continuazione, se l'elenco di connessioni restituite non include l'ultima delle connessioni filtrate.
Errori
EntityNotFoundExceptionOperationTimeoutExceptionInvalidInputExceptionGlueEncryptionException
UpdateConnection azione (Python: update_connection)
Aggiorna una definizione di connessione nel catalogo dati.
Richiesta
-
CatalogId: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.L'ID del catalogo dati in cui risiede la connessione. Se non ne viene fornito nessuno, l'ID dell' AWS account viene utilizzato per impostazione predefinita.
-
Name— UTF-8 Obbligatoria: stringa, lunga non meno di 1 o più di 255 byte, corrispondente alSingle-line string pattern.Il nome della definizione di connessione da aggiornare.
-
ConnectionInput- obbligatorio: un oggetto ConnectionInput.Un oggetto
ConnectionInputche ridefinisce la connessione in questione.
Risposta
Nessun parametro di risposta.
Errori
InvalidInputExceptionEntityNotFoundExceptionOperationTimeoutExceptionInvalidInputExceptionGlueEncryptionException
TestConnection azione (Python: test_connection)
Verifica una connessione a un servizio per convalidare le credenziali del servizio fornite.
Puoi fornire un nome di connessione esistente o un TestConnectionInput per testare un input di connessione inesistente. La fornitura di entrambi nello stesso momento genera un errore.
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
Richiesta
-
ConnectionName— UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string patternOpzionale. Il nome della connessione da testare. Se viene fornito solo il nome, l'operazione otterrà la connessione e la utilizzerà per il test.
-
CatalogId: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.L'ID del catalogo in cui si trova la connessione.
-
TestConnectionInput: un oggetto TestConnectionInput.Una struttura utilizzata per specificare il test di una connessione a un servizio.
Risposta
Nessun parametro di risposta.
Errori
InvalidInputExceptionOperationTimeoutExceptionResourceNumberLimitExceededExceptionGlueEncryptionExceptionFederationSourceExceptionAccessDeniedExceptionEntityNotFoundExceptionConflictExceptionInternalServiceException
BatchDeleteConnection azione (Python: batch_delete_connection)
Elimina un elenco di definizioni di connessione dal catalogo dati.
Richiesta
-
CatalogId: stringa ID catalogo, non inferiore a 1 o superiore a 255 byte di lunghezza, corrispondente a Single-line string pattern.L'ID del catalogo dati in cui risiedono le connessioni. Se non ne viene fornito nessuno, per impostazione predefinita viene utilizzato l'ID dell' AWS account.
-
ConnectionNameList— Obbligatorio: una matrice di UTF-8 stringhe, non più di 25 stringhe.Un elenco di nomi delle connessioni da eliminare.
Risposta
-
Succeeded— Una serie di stringhe. UTF-8Un elenco di nomi delle definizioni di connessione la cui eliminazione è riuscita.
-
Errors: una matrice della mappa di coppie chiave-valore.Ogni chiave è una UTF-8 stringa, lunga non meno di 1 o più di 255 byte, corrispondente a. Single-line string pattern
Ogni valore è un oggetto ErrorDetail.
Una mappa dei nomi delle connessioni la cui eliminazione non è riuscita per i dettagli di errore.
Errori
InternalServiceExceptionOperationTimeoutException