Verbindungs-API - AWS Glue

Verbindungs-API

Die Verbindungs-API beschreibt AWS Glue-Verbindungsdatentypen und die API zum Erstellen, Löschen, Aktualisieren und Auflisten von Verbindungen.

Datentypen

Connection-Struktur

Definiert eine Verbindung zu einer Datenquelle.

Felder
  • Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name der Verbindungsdefinition.

  • Description – Beschreibende Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum URI address multi-line string pattern.

    Beschreibung der Verbindung.

  • ConnectionType – UTF-8-Zeichenfolge (zulässige Werte: 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 | SLACK | STRIPE | INTERCOM | SNAPCHATADS).

    Typ der Verbindung. Derzeit wird SFTP nicht unterstützt.

  • MatchCriteria – Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 10 Zeichenfolgen.

    Eine Liste von Kriterien, die bei der Auswahl dieser Verbindung verwendet werden können.

  • ConnectionProperties – Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 100 Paare.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge (zulässige Werte: 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).

    Jeder Wert ist eine Wertzeichenfolge, die mindestens 1 und höchstens 1024 Bytes lang ist.

    Diese Schlüssel-Wert-Paare definieren Parameter für die Verbindung bei Verwendung des Verbindungsschemas der Version 1:

    • HOST – Der Host-URI: entweder der vollständig qualifizierte Domain-Name (FQDN, Fully Qualified Domain Name) oder die IPv4-Adresse des Datenbank-Hosts.

    • PORT – Die Portnummer zwischen 1024 und 65535 des Ports, auf dem der Datenbank-Host auf Datenbankverbindungen wartet.

    • USER_NAME – Der Name, unter dem Sie sich bei der Datenbank anmelden. Die Wert-Zeichenfolge für USER_NAME ist „USERNAME“.

    • PASSWORD – Ein Passwort, falls eines verwendet wird, für den Benutzernamen.

    • ENCRYPTED_PASSWORD – Wenn Sie den Verbindungspasswortschutz aktivieren, indem Sie in den Verschlüsselungseinstellungen des Data Catalog ConnectionPasswordEncryption festlegen, wird das verschlüsselte Passwort in diesem Feld gespeichert.

    • JDBC_DRIVER_JAR_URI – Der Amazon Simple Storage Service (Amazon S3)-Pfad der JAR-Datei, die den zu verwendenden JDBC-Treiber enthält.

    • JDBC_DRIVER_CLASS_NAME – Der Klassenname des zu verwendenden JDBC-Treibers.

    • JDBC_ENGINE – Der Name der zu verwendenden JDBC-Engine.

    • JDBC_ENGINE_VERSION – Die zu verwendende Version der JDBC-Engine.

    • CONFIG_FILES - (Zur späteren Verwendung reserviert.)

    • INSTANCE_ID – Die zu verwendende Instance-ID.

    • JDBC_CONNECTION_URL – Die URL für die Verbindung mit einer JDBC-Datenquelle.

    • JDBC_ENFORCE_SSL – Eine boolesche Zeichenfolge (true, false), bei der die Groß-/Kleinschreibung nicht beachtet wird und die angibt, ob Secure Sockets Layer (SSL) mit übereinstimmenden Hostnamen für die JDBC-Verbindung auf dem Client erzwungen wird. Der Standardwert lautet „false“.

    • CUSTOM_JDBC_CERT – Ein Amazon-S3-Speicherort, der das Stammzertifikat des Kunden angibt. AWS Glue verwendet dieses Stammzertifikat, um das Zertifikat des Kunden zu validieren, wenn eine Verbindung mit der Kundendatenbank hergestellt wird. AWS Glue verarbeitet nur X.509-Zertifikate. Das bereitgestellte Zertifikat muss DER-codiert sein und im Base64-PEM-Codierungsformat bereitgestellt werden.

    • SKIP_CUSTOM_JDBC_CERT_VALIDATION – Standardmäßig ist dies false. AWS Glue validiert den Signaturalgorithmus und den Algorithmus für den öffentlichen Schlüssel für das Kundenzertifikat. Die einzigen zulässigen Algorithmen für den Signaturalgorithmus sind SHA256withRSA, SHA384withRSA oder SHA512withRSA. Die Schlüssellänge für den Algorithmus für den öffentlichen Schlüssel muss mindestens 2048 betragen. Sie können den Wert dieser Eigenschaft auf true festlegen, um die AWS Glue-Validierung des Kundenzertifikats zu überspringen.

    • CUSTOM_JDBC_CERT_STRING – Eine benutzerdefinierte JDBC-Zertifikatzeichenfolge, die für einen Domainabgleich oder einen Distinguished Name-Abgleich verwendet wird, um Man-in-the-Middle-Angriffe zu verhindern. In Oracle Database wird sie als SSL_SERVER_CERT_DN verwendet. In Microsoft SQL Server wird sie als hostNameInCertificate verwendet.

    • CONNECTION_URL – Die URL für die Verbindung mit einer allgemeinen Datenquelle (nicht JDBC).

    • SECRET_ID – Die geheime ID, die für den Secrets Manager der Anmeldeinformationen verwendet wird.

    • CONNECTOR_URL – Die Connector-URL für eine MARKETPLACE- oder CUSTOM-Verbindung.

    • CONNECTOR_TYPE – Der Konnektor-Typ für eine MARKETPLACE- oder CUSTOM-Verbindung.

    • CONNECTOR_CLASS_NAME – Die Konnektor-Klassenname für eine MARKETPLACE- oder CUSTOM-Verbindung.

    • KAFKA_BOOTSTRAP_SERVERS - Eine durch Kommata getrennte Liste von Host- und Portpaaren, die die Adressen der Apache Kafka Broker in einem Kafka-Cluster sind, zu dem ein Kafka-Client eine Verbindung herstellt und Bootstrapping durchführt.

    • KAFKA_SSL_ENABLED – Ob SSL auf einer Apache-Kafka-Verbindung aktiviert oder deaktiviert werden soll. Der Standardwert ist „true“.

    • KAFKA_CUSTOM_CERT – Die Amazon-S3-URL für die private CA-Zertifikatdatei (PEM-Format). Der Standardwert ist eine leere Zeichenfolge.

    • KAFKA_SKIP_CUSTOM_CERT_VALIDATION – Ob die Validierung der CA-Zertifikatdatei übersprungen werden soll oder nicht. AWS Glue validiert für drei Algorithmen: SHA256withRSA, SHA384withRSA und SHA512withRSA. Der Standardwert ist „false“.

    • KAFKA_CLIENT_KEYSTORE – Der Amazon-S3-Speicherort der Client-Keystore-Datei für die clientseitige Kafka-Authentifizierung (optional).

    • KAFKA_CLIENT_KEYSTORE_PASSWORD – Das Passwort für den Zugriff auf den bereitgestellten Keystore (optional).

    • KAFKA_CLIENT_KEY_PASSWORD – Ein Keystore kann aus mehreren Schlüsseln bestehen, also ist dies das Passwort für den Zugriff auf den Clientschlüssel, der mit dem serverseitigen Kafka-Schlüssel verwendet werden soll (optional).

    • ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD – Die verschlüsselte Version des Kafka-Client-Keystore-Passworts (wenn der Benutzer die AWS Glue-Einstellung zum Verschlüsseln von Passwörtern ausgewählt hat).

    • ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD – Die verschlüsselte Version des Kafka-Client-Schlüssel-Passworts (wenn der Benutzer die AWS Glue-Einstellung zum Verschlüsseln von Passwörtern ausgewählt hat).

    • KAFKA_SASL_MECHANISM"SCRAM-SHA-512", "GSSAPI", "AWS_MSK_IAM" oder "PLAIN". Dies sind die unterstützten SASL-Mechanismen.

    • KAFKA_SASL_PLAIN_USERNAME – Ein Klartext-Benutzername, der zur Authentifizierung mit dem Mechanismus „PLAIN“ verwendet wird.

    • KAFKA_SASL_PLAIN_PASSWORD – Ein Klartext-Passwort, das zur Authentifizierung mit dem Mechanismus „PLAIN“ verwendet wird.

    • ENCRYPTED_KAFKA_SASL_PLAIN_PASSWORD – Die verschlüsselte Version des Kafka-SASL-PLAIN-Passworts (wenn der Benutzer die Einstellung von AWS Glue zum Verschlüsseln von Passwörtern ausgewählt hat).

    • KAFKA_SASL_SCRAM_USERNAME – Ein Klartext-Benutzername, der zur Authentifizierung mit dem Mechanismus „SCRAM-SHA-512" verwendet wird.

    • KAFKA_SASL_SCRAM_PASSWORD – Ein Klartext-Passwort, das zur Authentifizierung mit dem Mechanismus „SCRAM-SHA-512" verwendet wird.

    • ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD – Die verschlüsselte Version des Kafka-SASL-SCRAM-Passworts (wenn der Benutzer die AWS Glue-Einstellung zum Verschlüsseln von Passwörtern ausgewählt hat).

    • KAFKA_SASL_SCRAM_SECRETS_ARN – Der Amazon-Ressourcenname eines Geheimnisses im AWS Secrets Manager.

    • KAFKA_SASL_GSSAPI_KEYTAB – Der S3-Speicherort einer Kerberos-keytab-Datei. Ein Keytab speichert Langzeitschlüssel für ein oder mehrere Prinzipale. Weitere Informationen finden Sie unter MIT-Kerberos-Dokumentation: Keytab.

    • KAFKA_SASL_GSSAPI_KRB5_CONF – Der S3-Speicherort einer Kerberos-krb5.conf-Datei. Eine krb5.conf speichert Kerberos-Konfigurationsinformationen, z. B. den Standort des KDC-Servers. Weitere Informationen finden Sie in der MIT-Kerberos-Dokumentation: krb5.conf.

    • KAFKA_SASL_GSSAPI_SERVICE – Der Name des Kerberos-Services, wie er in Ihrer Kafka-Konfiguration mit sasl.kerberos.service.name festgelegt wurde.

    • KAFKA_SASL_GSSAPI_PRINCIPAL – Der Name des von AWS Glue verwendeten Kerberos-Prinzipals. Weitere Informationen finden Sie in der Kafka-Dokumentation: Konfigurieren von Kafka-Brokern.

    • ROLE_ARN – Die Rolle, die für die Ausführung von Abfragen verwendet werden soll.

    • REGION – Die AWS-Region, in der Abfragen ausgeführt werden.

    • WORKGROUP_NAME – Der Name einer Arbeitsgruppe von Amazon Redshift Serverless oder einer Amazon-Athena-Arbeitsgruppe, in der die Abfragen ausgeführt werden.

    • CLUSTER_IDENTIFIER – Die Cluster-ID eines Amazon-Redshift-Clusters, in dem die Abfragen ausgeführt werden.

    • DATABASE – Die Amazon-Redshift-Datenbank, mit der Sie eine Verbindung herstellen.

  • SparkProperties – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.

    Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.

    Spezifische Verbindungseigenschaften für die Spark-Datenverarbeitungsumgebung.

  • AthenaProperties – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.

    Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.

    Spezifische Verbindungseigenschaften für die Athena-Datenverarbeitungsumgebung.

  • PythonProperties – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.

    Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.

    Spezifische Verbindungseigenschaften für die Python-Datenverarbeitungsumgebung.

  • PhysicalConnectionRequirements – Ein PhysicalConnectionRequirements-Objekt.

    Die physischen Verbindungsanforderungen, z. B. Virtual Private Cloud (VPC) und SecurityGroup, die erforderlich sind, um diese Verbindung erfolgreich herzustellen.

  • CreationTime – Zeitstempel.

    Der Zeitstempel der Erstellung dieser Verbindungsdefinition.

  • LastUpdatedTime – Zeitstempel.

    Der Zeitstempel der letzten Aktualisierung der Verbindungsdefinition.

  • LastUpdatedBy – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Benutzer, die Gruppe oder die Rolle, von dem bzw. der diese Verbindung zuletzt aktualisiert wurde.

  • Status – UTF-8-Zeichenfolge (zulässige Werte: READY | IN_PROGRESS | FAILED).

    Der Status der Verbindung. Dabei kann es sich um READY, IN_PROGRESS oder FAILED handeln.

  • StatusReason – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 16384 Bytes lang.

    Der Grund für den Verbindungsstatus.

  • LastConnectionValidationTime – Zeitstempel.

    Ein Zeitstempel, der den Zeitpunkt der letzten Überprüfung dieser Verbindung angibt.

  • AuthenticationConfiguration – Ein AuthenticationConfiguration-Objekt.

    Die Authentifizierungseigenschaften der Verbindung.

  • ConnectionSchemaVersion – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 2.

    Die Version des Verbindungsschemas für diese Verbindung. Version 2 unterstützt Eigenschaften für bestimmte Datenverarbeitungsumgebungen.

  • CompatibleComputeEnvironments – Ein UTF-8-Zeichenfolgen-Array.

    Eine Liste von Datenverarbeitungsumgebungen, die mit der Verbindung kompatibel sind.

ConnectionInput-Struktur

Eine Struktur, die zum Angeben einer Verbindung verwendet wird, die erstellt oder aktualisiert werden soll.

Felder
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name der Verbindung.

  • Description – Beschreibende Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum URI address multi-line string pattern.

    Beschreibung der Verbindung.

  • ConnectionTypeErforderlich: UTF-8-Zeichenfolge (zulässige Werte: 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 | SLACK | STRIPE | INTERCOM | SNAPCHATADS).

    Typ der Verbindung. Derzeit werden folgende Typen unterstützt:

    • JDBC – Gibt eine Verbindung mit einer Datenbank über Java Database Connectivity (JDBC) an.

      JDBC-Verbindungen verwenden die folgenden ConnectionParameters.

      • Erforderlich: Alle von (HOST, PORT, JDBC_ENGINE) oder JDBC_CONNECTION_URL.

      • Erforderlich: Alle (USERNAME, PASSWORD,) oder SECRET_ID.

      • Optional: JDBC_ENFORCE_SSL, CUSTOM_JDBC_CERT, CUSTOM_JDBC_CERT_STRING, SKIP_CUSTOM_JDBC_CERT_VALIDATION. Diese Parameter werden verwendet, um SSL mit JDBC zu konfigurieren.

    • KAFKA - Bezeichnet eine Verbindung zu einer Apache-Kafka-Streaming-Plattform.

      KAFKA-Verbindungen verwenden die folgenden ConnectionParameters.

      • Erforderlich: KAFKA_BOOTSTRAP_SERVERS.

      • Optional: KAFKA_SSL_ENABLED, KAFKA_CUSTOM_CERT, KAFKA_SKIP_CUSTOM_CERT_VALIDATION. Diese Parameter werden verwendet, um SSL mit KAFKA zu konfigurieren.

      • Optional: KAFKA_CLIENT_KEYSTORE, KAFKA_CLIENT_KEYSTORE_PASSWORD, KAFKA_CLIENT_KEY_PASSWORD, ENCRYPTED_KAFKA_CLIENT_KEYSTORE_PASSWORD, ENCRYPTED_KAFKA_CLIENT_KEY_PASSWORD. Diese Parameter werden verwendet, um TLS-Client-Konfiguration mit SSL in KAFKA zu konfigurieren.

      • Optional: KAFKA_SASL_MECHANISM. Kann als SCRAM-SHA-512, GSSAPI oder AWS_MSK_IAM angegeben werden.

      • Optional: KAFKA_SASL_SCRAM_USERNAME, KAFKA_SASL_SCRAM_PASSWORD, ENCRYPTED_KAFKA_SASL_SCRAM_PASSWORD. Diese Parameter werden verwendet, um SASL/SCRAM-SHA-512-Authentifizierung mit KAFKA zu konfigurieren.

      • Optional: KAFKA_SASL_GSSAPI_KEYTAB, KAFKA_SASL_GSSAPI_KRB5_CONF, KAFKA_SASL_GSSAPI_SERVICE, KAFKA_SASL_GSSAPI_PRINCIPAL. Diese Parameter werden verwendet, um die SASL/GSSAPI-Authentifizierung mit KAFKA zu konfigurieren.

    • MONGODB – Gibt eine Verbindung zu einer MongoDB-Dokumentdatenbank an.

      MONGODB-Verbindungen verwenden die folgenden ConnectionParameters.

      • Erforderlich: CONNECTION_URL.

      • Erforderlich: Alle von (USERNAME, PASSWORD) oder SECRET_ID.

    • VIEW_VALIDATION_REDSHIFT – Bezeichnet eine Verbindung, die von Amazon Redshift zur Überprüfung von Ansichten verwendet wird.

    • VIEW_VALIDATION_ATHENA – Bezeichnet eine Verbindung, die von Amazon Athena zur Überprüfung von Ansichten verwendet wird.

    • NETWORK – Bezeichnet eine Netzwerkverbindung zu einer Datenquelle in einer Amazon Virtual Private Cloud-Umgebung (Amazon VPC).

      NETWORK-Verbindungen erfordern keine ConnectionParameters. Geben Sie stattdessen PhysicalConnectionRequirements an.

    • MARKETPLACE – Verwendet die in einem Konnektor enthaltenen Konfigurationseinstellungen, der von AWS Marketplace zum Lesen und Schreiben in nicht nativ von AWS Glue unterstützten Datastores erworben wurde.

      MARKETPLACE-Verbindungen verwenden die folgenden ConnectionParameters.

      • Erforderlich: CONNECTOR_TYPE, CONNECTOR_URL, CONNECTOR_CLASS_NAME, CONNECTION_URL.

      • Erforderlich für JDBC CONNECTOR_TYPE-Verbindungen: Alle von (USERNAME, PASSWORD) oder SECRET_ID.

    • CUSTOM – Verwendet die in einem benutzerdefinierten Konnektor enthaltenen Konfigurationseinstellungen, der zum Lesen und Schreiben in nicht nativ von AWS Glue unterstützten Datastores erworben wurde.

    Darüber hinaus wird ein ConnectionType für die folgenden SaaS-Connectors unterstützt:

    • FACEBOOKADS – Bezeichnet eine Verbindung mit Facebook Ads.

    • GOOGLEADS – Bezeichnet eine Verbindung mit Google Ads.

    • GOOGLESHEETS – Bezeichnet eine Verbindung mit Google Sheets.

    • GOOGLEANALYTICS4 – Bezeichnet eine Verbindung mit Google Analytics 4.

    • HUBSPOT – Bezeichnet eine Verbindung mit HubSpot.

    • INSTAGRAMADS – Bezeichnet eine Verbindung mit Instagram Ads.

    • INTERCOM – Bezeichnet eine Verbindung mit Intercom.

    • JIRACLOUD – Bezeichnet eine Verbindung mit Jira Cloud.

    • MARKETO – Bezeichnet eine Verbindung mit Adobe Marketo Engage.

    • NETSUITEERP – Bezeichnet eine Verbindung mit Oracle NetSuite.

    • SALESFORCE – Bezeichnet eine Verbindung mit Salesforce mithilfe der OAuth-Authentifizierung.

    • SALESFORCEMARKETINGCLOUD – Bezeichnet eine Verbindung mit Salesforce Marketing Cloud.

    • SALESFORCEPARDOT – Bezeichnet eine Verbindung mit Salesforce Marketing Cloud Account Engagement (MCAE).

    • SAPODATA – Bezeichnet eine Verbindung mit SAP OData.

    • SERVICENOW – Bezeichnet eine Verbindung mit ServiceNow.

    • SLACK – Bezeichnet eine Verbindung mit Slack.

    • SNOWFLAKE – Bezeichnet eine Verbindung mit Snowflake.

    • SNAPCHATADS – Bezeichnet eine Verbindung mit Snapchat Ads.

    • STRIPE – Bezeichnet eine Verbindung mit Stripe.

    • ZENDESK – Bezeichnet eine Verbindung mit Zendesk.

    • ZOHOCRM – Bezeichnet eine Verbindung mit Zoho CRM.

    • ADOBEANALYTICS – Bezeichnet eine Verbindung mit Adobe Analytics.

    • LINKEDIN – Bezeichnet eine Verbindung mit LinkedIn.

    • MIXPANEL – Bezeichnet eine Verbindung mit Mixpanel.

    • ASANA – Bezeichnet eine Verbindung mit Asana.

    • SMARTSHEET – Bezeichnet eine Verbindung mit Smartsheet.

    • DATADOG – Bezeichnet eine Verbindung mit Datadog.

    • WOOCOMMERCE – Bezeichnet eine Verbindung mit WooCommerce.

    • PAYPAL – Bezeichnet eine Verbindung mit PayPal.

    • QUICKBOOKS – Bezeichnet eine Verbindung mit QuickBooks.

    • FACEBOOKPAGEINSIGHTS – Bezeichnet eine Verbindung mit Facebook Page Insights.

    • FRESHDESK – Bezeichnet eine Verbindung mit Freshdesk.

    • TWILIO – Bezeichnet eine Verbindung mit Twilio.

    • DOCUSIGNMONITOR – Bezeichnet eine Verbindung mit DocuSign Monitor.

    • FRESHSALES – Bezeichnet eine Verbindung mit Freshsales.

    • ZOOM – Bezeichnet eine Verbindung mit Zoom.

    • GOOGLESEARCHCONSOLE – Bezeichnet eine Verbindung mit Google Search Console.

    • SALESFORCECOMMERCECLOUD – Bezeichnet eine Verbindung mit Salesforce Commerce Cloud.

    • SAPCONCUR – Bezeichnet eine Verbindung mit SAP Concur.

    • DYNATRACE – Bezeichnet eine Verbindung mit Dynatrace.

    • MICROSOFTDYNAMIC365FINANCEANDOPS – Bezeichnet eine Verbindung mit Microsoft Dynamics 365 Finance and Operations.

    • MICROSOFTTEAMS – Bezeichnet eine Verbindung mit Microsoft Teams.

    • BLACKBAUDRAISEREDGENXT – Bezeichnet eine Verbindung mit Blackbaud Raiser's Edge NXT.

    • MAILCHIMP – Bezeichnet eine Verbindung mit Mailchimp.

    • GITLAB – Bezeichnet eine Verbindung mit GitLab.

    • PENDO – Bezeichnet eine Verbindung mit Pendo.

    • PRODUCTBOARD – Bezeichnet eine Verbindung mit Productboard.

    • CIRCLECI – Bezeichnet eine Verbindung mit CircleCI.

    • PIPEDIVE – Bezeichnet eine Verbindung mit Pipedrive.

    • SENDGRID – Bezeichnet eine Verbindung mit SendGrid.

    Weitere Informationen zu den für einen bestimmten Connector erforderlichen Verbindungsparametern finden Sie in der Dokumentation zum Connector im Abschnitt Hinzufügen einer AWS Glue-Verbindung im AWS Glue-Benutzerhandbuch.

    SFTP wird nicht unterstützt.

    Weitere Informationen darüber, wie optionale ConnectionProperties zur Konfiguration der Features in AWS Glue verwendet werden, finden Sie unter AWS Glue-Verbindungseigenschaften.

    Weitere Informationen darüber, wie optionale ConnectionProperties zur Konfiguration der Features in AWS Glue Studio verwendet werden, finden Sie unter Verwenden von Konnektoren und Verbindungen.

  • MatchCriteria – Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 10 Zeichenfolgen.

    Eine Liste von Kriterien, die bei der Auswahl dieser Verbindung verwendet werden können.

  • ConnectionPropertiesErforderlich: Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 100 Paare.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge (zulässige Werte: 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).

    Jeder Wert ist eine Wertzeichenfolge, die mindestens 1 und höchstens 1024 Bytes lang ist.

    Diese Schlüssel-Wert-Paare definieren Parameter für die Verbindung.

  • SparkProperties – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.

    Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.

    Spezifische Verbindungseigenschaften für die Spark-Datenverarbeitungsumgebung.

  • AthenaProperties – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.

    Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.

    Spezifische Verbindungseigenschaften für die Athena-Datenverarbeitungsumgebung.

  • PythonProperties – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.

    Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.

    Spezifische Verbindungseigenschaften für die Python-Datenverarbeitungsumgebung.

  • PhysicalConnectionRequirements – Ein PhysicalConnectionRequirements-Objekt.

    Die physischen Verbindungsanforderungen, z. B. Virtual Private Cloud (VPC) und SecurityGroup, die erforderlich sind, um diese Verbindung erfolgreich herzustellen.

  • AuthenticationConfiguration – Ein AuthenticationConfigurationInput-Objekt.

    Die Authentifizierungseigenschaften der Verbindung.

  • ValidateCredentials – Boolesch.

    Eine Markierung zur Überprüfung der Anmeldeinformationen beim Erstellen der Verbindung. Der Standardwert ist „true“.

  • ValidateForComputeEnvironments – Ein UTF-8-Zeichenfolgen-Array.

    Die Datenverarbeitungsumgebungen, gegen die die angegebenen Verbindungseigenschaften validiert werden.

TestConnectionInput-Struktur

Eine Struktur, die zum Angeben des Testens einer Verbindung zu einem Service verwendet wird.

Felder
  • ConnectionTypeErforderlich: UTF-8-Zeichenfolge (zulässige Werte: 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 | SLACK | STRIPE | INTERCOM | SNAPCHATADS).

    Der zu testende Verbindungstyp. Dieser Vorgang ist nur für die Verbindungen JDBC oder SALESFORCE verfügbar.

  • ConnectionPropertiesErforderlich: Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 100 Paare.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge (zulässige Werte: 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).

    Jeder Wert ist eine Wertzeichenfolge, die mindestens 1 und höchstens 1024 Bytes lang ist.

    Die Schlüssel-Wert-Paare, die die Parameter für die Verbindung definieren.

    JDBC-Verbindungen verwenden die folgenden Verbindungseigenschaften:

    • Erforderlich: Alle von (HOST, PORT, JDBC_ENGINE) oder JDBC_CONNECTION_URL.

    • Erforderlich: Alle (USERNAME, PASSWORD,) oder SECRET_ID.

    • Optional: JDBC_ENFORCE_SSL, CUSTOM_JDBC_CERT, CUSTOM_JDBC_CERT_STRING, SKIP_CUSTOM_JDBC_CERT_VALIDATION. Diese Parameter werden verwendet, um SSL mit JDBC zu konfigurieren.

    Für SALESFORCE-Verbindungen muss das AuthenticationConfiguration-Mitglied konfiguriert werden.

  • AuthenticationConfiguration – Ein AuthenticationConfigurationInput-Objekt.

    Eine Struktur, die die Authentifizierungskonfiguration in der TestConnection-Anfrage enthält. Erforderlich für eine Verbindung zu Salesforce mittels OAuth-Authentifizierung.

PhysicalConnectionRequirements-Struktur

Die OAuth-Client-App in der GetConnection-Antwort.

Felder
  • SubnetId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die Subnetz-ID, die von der Verbindung verwendet wird.

  • SecurityGroupIdList – Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 50 Zeichenfolgen.

    Die Sicherheitsgruppen-ID-Liste, die von der Verbindung verwendet wird.

  • AvailabilityZone – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die Availability Zone der Verbindung.

GetConnectionsFilter-Struktur

Filtert die von der GetConnections-API-Operation zurückgegebenen Verbindungsdefinitionen.

Felder
  • MatchCriteria – Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 10 Zeichenfolgen.

    Eine Kriterienzeichenfolge, die den Kriterien entsprechen muss, die in der Verbindungsdefinition hinterlegt sind, damit diese Verbindungsdefinition zurückgegeben wird.

  • ConnectionType – UTF-8-Zeichenfolge (zulässige Werte: 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 | SLACK | STRIPE | INTERCOM | SNAPCHATADS).

    Der Typ von Verbindungen, der zurückgegeben werden soll. Derzeit wird SFTP nicht unterstützt.

  • ConnectionSchemaVersion – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 2.

    Gibt an, ob die Verbindung mit Schemaversion 1 oder 2 erstellt wurde.

AuthenticationConfiguration-Struktur

Eine Struktur, die die Authentifizierungskonfiguration enthält.

Felder
  • AuthenticationType – UTF-8-Zeichenfolge (zulässige Werte: BASIC | OAUTH2 | CUSTOM | IAM).

    Eine Struktur, die die Authentifizierungskonfiguration enthält.

  • SecretArn – UTF-8-Zeichenfolge, die Custom string pattern #36 entspricht.

    Der Secret-Manager-ARN zur Speicherung von Anmeldeinformationen.

  • KmsKeyArn – UTF-8-Zeichenfolge, die Custom string pattern #29 entspricht.

    Der Amazon-Ressourcenname (ARN) des KMS-Schlüssels zum Verschlüsseln vertraulicher Authentifizierungsinformationen. Dieser Schlüssel dient dem Schutz von Anmeldeinformationen und anderen sensiblen Daten, die in der Authentifizierungskonfiguration gespeichert sind.

  • OAuth2Properties – Ein OAuth2Properties-Objekt.

    Die Eigenschaften für die OAuth2-Authentifizierung.

AuthenticationConfigurationInput-Struktur

Eine Struktur, die die Authentifizierungskonfiguration in der CreateConnection-Anfrage enthält.

Felder
  • AuthenticationType – UTF-8-Zeichenfolge (zulässige Werte: BASIC | OAUTH2 | CUSTOM | IAM).

    Eine Struktur, die die Authentifizierungskonfiguration in der CreateConnection-Anfrage enthält.

  • OAuth2Properties – Ein OAuth2PropertiesInput-Objekt.

    Die Eigenschaften für die OAuth2-Authentifizierung in der CreateConnection-Anfrage.

  • SecretArn – UTF-8-Zeichenfolge, die Custom string pattern #36 entspricht.

    Der Secret-Manager-ARN zum Speichern von Anmeldeinformationen in der CreateConnection-Anfrage.

  • KmsKeyArn – UTF-8-Zeichenfolge, die Custom string pattern #29 entspricht.

    Der ARN des KMS-Schlüssels, der zur Verschlüsselung der Verbindung verwendet wurde. Er wird ausschließlich als Eingabe in der Anfrage akzeptiert und im Secret Manager gespeichert.

  • BasicAuthenticationCredentials – Ein BasicAuthenticationCredentials-Objekt.

    Die Anmeldeinformationen, die verwendet werden, wenn es sich bei dem Authentifizierungstyp um eine Standardauthentifizierung handelt.

  • CustomAuthenticationCredentials – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.

    Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 2048 Bytes lang ist.

    Die Anmeldeinformationen, die verwendet werden, wenn es sich bei dem Authentifizierungstyp um eine benutzerdefinierte Authentifizierung handelt.

OAuth2Properties-Struktur

Eine Struktur mit Eigenschaften für die OAuth2-Authentifizierung.

Felder
  • OAuth2GrantType – UTF-8-Zeichenfolge (zulässige Werte: AUTHORIZATION_CODE | CLIENT_CREDENTIALS | JWT_BEARER).

    Der OAuth2-Gewährungstyp. Beispiel: AUTHORIZATION_CODE, JWT_BEARER oder CLIENT_CREDENTIALS.

  • OAuth2ClientApplication – Ein OAuth2ClientApplication-Objekt.

    Der Client-Anwendungstyp. Zum Beispiel AWS_MANAGED oder USER_MANAGED.

  • TokenUrl – UTF-8-Zeichenfolge, nicht mehr als 256 Bytes lang, passend zum Custom string pattern #40.

    Die URL des Authentifizierungsservers des Anbieters für den Austausch eines Autorisierungscodes gegen ein Zugriffstoken.

  • TokenUrlParametersMap – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.

    Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 512 Bytes lang ist.

    Eine Zuordnung von Parametern, die der Token-GET-Anfrage hinzugefügt werden.

OAuth2PropertiesInput-Struktur

Eine Struktur mit Eigenschaften für OAuth2 in der CreateConnection-Anfrage.

Felder
  • OAuth2GrantType – UTF-8-Zeichenfolge (zulässige Werte: AUTHORIZATION_CODE | CLIENT_CREDENTIALS | JWT_BEARER).

    Der OAuth2-Gewährungstyp in der CreateConnection-Anfrage. Beispiel: AUTHORIZATION_CODE, JWT_BEARER oder CLIENT_CREDENTIALS.

  • OAuth2ClientApplication – Ein OAuth2ClientApplication-Objekt.

    Der Typ der Client-Anwendung in der CreateConnection-Anfrage. Zum Beispiel AWS_MANAGED oder USER_MANAGED.

  • TokenUrl – UTF-8-Zeichenfolge, nicht mehr als 256 Bytes lang, passend zum Custom string pattern #40.

    Die URL des Authentifizierungsservers des Anbieters für den Austausch eines Autorisierungscodes gegen ein Zugriffstoken.

  • TokenUrlParametersMap – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.

    Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 512 Bytes lang ist.

    Eine Zuordnung von Parametern, die der Token-GET-Anfrage hinzugefügt werden.

  • AuthorizationCodeProperties – Ein AuthorizationCodeProperties-Objekt.

    Die für den OAuth2-AUTHORIZATION_CODE-Gewährungstyp erforderlichen Eigenschaften.

  • OAuth2Credentials – Ein OAuth2Credentials-Objekt.

    Die Anmeldeinformationen, die verwendet werden, wenn es sich bei dem Authentifizierungstyp um eine OAuth2-Authentifizierung handelt.

OAuth2ClientApplication-Struktur

Die für die Verbindung verwendete OAuth2-Client-App.

Felder
  • UserManagedClientApplicationClientId – UTF-8-Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum Custom string pattern #37.

    Die Client-ID der Client-Anwendung, wenn der ClientAppType USER_MANAGED ist.

  • AWSManagedClientApplicationReference – UTF-8-Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum Custom string pattern #37.

    Der Verweis auf die von AWS verwaltete SaaS-seitige Client-App.

AuthorizationCodeProperties-Struktur

Die für den Workflow des OAuth2-AUTHORIZATION_CODE-Gewährungstyps erforderlichen Eigenschaften.

Felder
  • AuthorizationCode – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 4096 Bytes lang, passend zum Custom string pattern #37.

    Ein Autorisierungscode, der in der dritten Phase des AUTHORIZATION_CODE-Gewährungs-Workflows verwendet werden soll. Dieser Code ist nur einmal verwendbar und wird ungültig, sobald er gegen ein Zugriffstoken ausgetauscht wird. Daher ist es zulässig, diesen Wert als Anforderungsparameter zu verwenden.

  • RedirectUri – UTF-8-Zeichenfolge, nicht mehr als 512 Bytes lang, passend zum Custom string pattern #41.

    Die Umleitungs-URI, zu der der Benutzer bei der Ausgabe eines Autorisierungscodes vom Autorisierungsserver umgeleitet wird. Diese URI wird anschließend verwendet, wenn der Autorisierungscode gegen ein Zugriffstoken ausgetauscht wird.

BasicAuthenticationCredentials-Struktur

Zur Bereitstellung von Anmeldeinformationen für die Basisauthentifizierung, wenn kein SecretArn-Wert angegeben wird.

Felder
  • Username – UTF-8-Zeichenfolge, nicht mehr als 512 Bytes lang, passend zum Custom string pattern #37.

    Der Benutzername zur Verbindung mit der Datenquelle.

  • Password – UTF-8-Zeichenfolge, nicht mehr als 512 Bytes lang, passend zum Custom string pattern #33.

    Das Passwort für die Verbindung zur Datenquelle.

OAuth2Credentials-Struktur

Die Anmeldeinformationen, die verwendet werden, wenn es sich bei dem Authentifizierungstyp um eine OAuth2-Authentifizierung handelt.

Felder
  • UserManagedClientApplicationClientSecret – UTF-8-Zeichenfolge, nicht mehr als 512 Bytes lang, passend zum Custom string pattern #38.

    Das Client-Geheimnis der Client-Anwendung, wenn die Client-Anwendung vom Benutzer verwaltet wird.

  • AccessToken – UTF-8-Zeichenfolge, nicht mehr als 4096 Bytes lang, passend zum Custom string pattern #38.

    Das Zugriffstoken, das verwendet wird, wenn der Authentifizierungstyp OAuth2 ist.

  • RefreshToken – UTF-8-Zeichenfolge, nicht mehr als 4096 Bytes lang, passend zum Custom string pattern #38.

    Das Aktualisierungstoken, das verwendet wird, wenn der Authentifizierungstyp OAuth2 ist.

  • JwtToken – UTF-8-Zeichenfolge, nicht mehr als 8000 Bytes lang, passend zum Custom string pattern #39.

    Das JSON Web Token (JWT), das verwendet wird, wenn der Authentifizierungstyp OAuth2 ist.

Operationen

CreateConnection-Aktion (Python: create_connection)

Erstellt eine Verbindungsdefinition im Data Catalog.

Verbindungen, die zum Erstellen von Verbundressourcen verwendet werden, erfordern die IAM-Berechtigung glue:PassConnection.

Anforderung
  • CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die ID des Data Catalog, in dem die Verbindung erstellt wird. Wird keine bereitgestellt, wird standardmäßig die AWS-Konto-ID verwendet.

  • ConnectionInputErforderlich: Ein ConnectionInput-Objekt.

    Ein ConnectionInput-Objekt, das die zu erstellende Verbindung definiert.

  • Tags – Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 50 Paare.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.

    Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht mehr als 256 Bytes lang ist.

    Die Tags, die Sie der Verbindung zuweisen.

Antwort
  • CreateConnectionStatus – UTF-8-Zeichenfolge (zulässige Werte: READY | IN_PROGRESS | FAILED).

    Der Status der Anfrage für die Verbindungserstellung. Die Anfrage kann bei bestimmten Authentifizierungstypen einige Zeit in Anspruch nehmen, beispielsweise beim Erstellen einer OAuth-Verbindung mit Tokenaustausch über VPC.

Fehler
  • AlreadyExistsException

  • InvalidInputException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • GlueEncryptionException

DeleteConnection-Aktion (Python: delete_connection)

Löscht eine Verbindung aus dem Data Catalog.

Anforderung
  • CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die ID des Data Catalog, in dem sich die Verbindung befindet. Wird keine bereitgestellt, wird standardmäßig die AWS-Konto-ID verwendet.

  • ConnectionNameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name der zu löschenden Verbindung.

Antwort
  • Keine Antwortparameter.

Fehler
  • EntityNotFoundException

  • OperationTimeoutException

GetConnection-Aktion (Python: get_connection)

Ruft eine Verbindungsdefinition aus dem Data Catalog ab.

Anforderung
  • CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die ID des Data Catalog, in dem sich die Verbindung befindet. Wird keine bereitgestellt, wird standardmäßig die AWS-Konto-ID verwendet.

  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name der Verbindungsdefinition, die abgerufen werden soll.

  • HidePassword – Boolesch.

    Damit können Sie die Verbindungsmetadaten abrufen, ohne das Passwort zurückzugeben. Beispielsweise verwendet die AWS Glue-Konsole dieses Flag, um die Verbindung abzurufen, zeigt aber das Passwort nicht an. Legen Sie diesen Parameter fest, wenn der Aufrufer möglicherweise nicht über die Berechtigung verfügt, das Passwort mithilfe des AWS KMS-Schlüssels zu entschlüsseln, aber die Berechtigung für den Zugriff auf die restlichen Verbindungseigenschaften hat.

  • ApplyOverrideForComputeEnvironment – UTF-8-Zeichenfolge (zulässige Werte: SPARK | ATHENA | PYTHON).

    Für Verbindungen, die in mehreren Diensten verwendet werden können, werden die zurückgegebenen Eigenschaften für die angegebene Datenverarbeitungsumgebung angegeben.

Antwort
  • Connection – Ein Verbindung-Objekt.

    Die angeforderte Verbindungsdefinition.

Fehler
  • EntityNotFoundException

  • OperationTimeoutException

  • InvalidInputException

  • GlueEncryptionException

GetConnections-Aktion (Python: get_connections)

Ruft eine Liste von Verbindungsdefinitionen aus dem Data Catalog ab.

Anforderung
  • CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die ID des Data Catalog, in dem sich die Verbindungen befinden. Wird keine bereitgestellt, wird standardmäßig die AWS-Konto-ID verwendet.

  • Filter – Ein GetConnectionsFilter-Objekt.

    Ein Filter, der steuert, welche Verbindungen zurückgegeben werden.

  • HidePassword – Boolesch.

    Damit können Sie die Verbindungsmetadaten abrufen, ohne das Passwort zurückzugeben. Beispielsweise verwendet die AWS Glue-Konsole dieses Flag, um die Verbindung abzurufen, zeigt aber das Passwort nicht an. Legen Sie diesen Parameter fest, wenn der Aufrufer möglicherweise nicht über die Berechtigung verfügt, das Passwort mithilfe des AWS KMS-Schlüssels zu entschlüsseln, aber die Berechtigung für den Zugriff auf die restlichen Verbindungseigenschaften hat.

  • NextToken – UTF-8-Zeichenfolge.

    Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist.

  • MaxResults – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000.

    Die maximale Anzahl von Verbindungen, die in einer Antwort zurückgegeben werden sollen.

Antwort
  • ConnectionList – Ein Array mit Verbindung-Objekten.

    Eine Liste von angeforderten Verbindungsdefinitionen.

  • NextToken – UTF-8-Zeichenfolge.

    Ein Fortsetzungs-Token, wenn die Liste der zurückgegebenen Verbindungen nicht die letzten gefilterten Verbindungen enthält.

Fehler
  • EntityNotFoundException

  • OperationTimeoutException

  • InvalidInputException

  • GlueEncryptionException

UpdateConnection-Aktion (Python: update_connection)

Aktualisiert eine Verbindungsdefinition im Data Catalog.

Anforderung
  • CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die ID des Data Catalog, in dem sich die Verbindung befindet. Wird keine bereitgestellt, wird standardmäßig die AWS-Konto-ID verwendet.

  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name der Verbindungsdefinition, die aktualisiert werden soll.

  • ConnectionInputErforderlich: Ein ConnectionInput-Objekt.

    Ein ConnectionInput-Objekt, das die jeweilige Verbindung neu definiert.

Antwort
  • Keine Antwortparameter.

Fehler
  • InvalidInputException

  • EntityNotFoundException

  • OperationTimeoutException

  • InvalidInputException

  • GlueEncryptionException

TestConnection-Aktion (Python: test_connection)

Testet eine Verbindung zu einem Dienst, um die von Ihnen angegebenen Anmeldeinformationen für den Dienst zu überprüfen.

Sie können entweder einen bestehenden Verbindungsnamen oder einen TestConnectionInput zum Testen einer nicht existierenden Verbindung angeben. Die gleichzeitige Angabe beider Werte führt zu einem Fehler.

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Anforderung
  • ConnectionName – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Optional. Der Name der zu testenden Verbindung. Wenn nur der Name angegeben wird, stellt der Vorgang die Verbindung her und verwendet diese zum Testen.

  • CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die Katalog-ID, in dem sich die Verbindung befindet.

  • TestConnectionInput – Ein TestConnectionInput-Objekt.

    Eine Struktur, die zum Angeben des Testens einer Verbindung zu einem Service verwendet wird.

Antwort
  • Keine Antwortparameter.

Fehler
  • InvalidInputException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • GlueEncryptionException

  • FederationSourceException

  • AccessDeniedException

  • EntityNotFoundException

  • ConflictException

  • InternalServiceException

BatchDeleteConnection-Aktion (Python: batch_delete_connection)

Löscht eine Liste von Verbindungsdefinitionen aus dem Data Catalog.

Anforderung
  • CatalogId – Katalog-ID-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die ID des Data Catalog, in dem sich die Verbindungen befinden. Wird keine bereitgestellt, wird standardmäßig die AWS-Konto-ID verwendet.

  • ConnectionNameListErforderlich: Ein Array mit UTF-8-Zeichenfolgen, nicht mehr als 25 Zeichenfolgen.

    Eine Liste der Namen der Verbindungen, die gelöscht werden sollen.

Antwort
  • Succeeded – Ein UTF-8-Zeichenfolgen-Array.

    Eine Liste der Namen der Verbindungsdefinitionen, die erfolgreich gelöscht wurden.

  • Errors – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, und entspricht dem Single-line string pattern.

    Jeder Wert ist ein An ErrorDetail-Objekt.

    Eine Zuweisung der Namen von Verbindungen, die nicht erfolgreich gelöscht wurden, zu Fehlerdetails.

Fehler
  • InternalServiceException

  • OperationTimeoutException