Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Herstellen einer Verbindung mit Zoom Meetings Zoom Meetings ist eine cloudbasierte Videokonferenzplattform, die für Videokonferenzen, Audiokonferenzen, Webinare, Besprechungsaufzeichnungen und Live-Chats genutzt werden kann. **Topics** + [AWS Glue Unterstützung für Zoom Meetings](zoom-meetings-support.md) + [Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten](zoom-meetings-configuring-iam-permissions.md) + [Konfiguration von Zoom Meetings](zoom-meetings-configuring.md) + [Konfigurieren der Zoom-Meetings-Client-App](zoom-meetings-configuring-client-app.md) + [Konfigurieren von Zoom-Meetings-Verbindungen](zoom-meetings-configuring-connections.md) + [Aus Zoom-Meetings-Entitäten lesen](zoom-meetings-reading-from-entities.md) + [Verbindungsoptionen für Zoom Meetings](zoom-meetings-connection-options.md) + [Einschränkungen für Zoom Meetings](zoom-meetings-limitations.md) # AWS Glue Unterstützung für Zoom Meetings AWS Glue unterstützt Zoom Meetings wie folgt: **Als Quelle unterstützt?** Ja. Sie können AWS Glue ETL-Jobs verwenden, um Daten aus Zoom Meetings abzufragen. **Als Ziel unterstützt?** Nein. **Unterstützte API-Versionen von Zoom Meetings** Die folgenden Versionen der Zoom-Meetings-API werden unterstützt: +   v2 # Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten Die folgende Beispielrichtlinie beschreibt die erforderlichen AWS IAM-Berechtigungen für das Erstellen und Verwenden von Verbindungen. Wenn Sie eine neue Rolle erstellen, erstellen Sie eine Richtlinie, die Folgendes enthält: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "glue:ListConnectionTypes", "glue:DescribeConnectionType", "glue:RefreshOAuth2Tokens", "glue:ListEntities", "glue:DescribeEntity" ], "Resource": "*" } ] } ``` ------ Wenn Sie die oben genannte Methode nicht verwenden möchten, verwenden Sie alternativ die folgenden verwalteten IAM-Richtlinien: + [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Gewährt Zugriff auf Ressourcen, die verschiedene AWS Glue Prozesse benötigen, um in Ihrem Namen ausgeführt zu werden. Zu diesen Ressourcen gehören AWS Glue Amazon S3, IAM, CloudWatch Logs und Amazon EC2. Wenn Sie die in dieser Richtlinie angegebene Benennungskonvention für Ressourcen einhalten, verfügen AWS Glue Prozesse über die erforderlichen Berechtigungen. Diese Richtlinie wird typischerweise mit Rollen verknüpft, die bei der Definition von Crawlern, Aufträgen und Entwicklungsendpunkten angegeben werden. + [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Gewährt vollen Zugriff auf AWS Glue Ressourcen, wenn eine Identität, der die Richtlinie zugeordnet ist, die AWS Managementkonsole verwendet. Wenn Sie die Namenskonvention für Ressourcen befolgen, die in dieser Richtlinie angegeben sind, haben Benutzer alle Konsolenfunktionalitäten. Diese Richtlinie wird normalerweise Benutzern der AWS Glue Konsole zugewiesen. # Konfiguration von Zoom Meetings Bevor Sie Daten aus Zoom Meetings AWS Glue übertragen können, müssen Sie die folgenden Anforderungen erfüllen: ## Mindestanforderungen Die folgenden Anforderungen sind Mindestanforderungen: + Sie haben ein Zoom-Meetings-Konto. + Ihr Zoom-Konto ist für den API-Zugriff aktiviert. + Sie haben in Ihrem Zoom Meetings-Konto eine OAuth2 App erstellt. Diese Integration stellt die Anmeldeinformationen bereit, die für den sicheren Zugriff auf Ihre Daten AWS Glue verwendet werden, wenn authentifizierte Anrufe an Ihr Konto getätigt werden. Weitere Informationen finden Sie unter [Konfigurieren der Zoom-Meetings-Client-App](zoom-meetings-configuring-client-app.md). Wenn Sie diese Anforderungen erfüllen, können Sie eine Verbindung AWS Glue zu Ihrem Zoom Meetings-Konto herstellen. Für typische Verbindungen müssen Sie in Zoom Meetings nichts weiter tun. # Konfigurieren der Zoom-Meetings-Client-App 1. Melden Sie sich im Zoom App Marketplace an. 1. Wählen Sie **Develop** > **Build App** aus. 1. Wählen Sie **Allgemeine App** für eine OAuth 2.0-basierte App. 1. Fügen Sie auf der Seite mit den **Basisinformationen** Informationen zur App hinzu oder aktualisieren Sie sie, z. B. den Namen der App, die Art und Weise, wie die App verwaltet wird, die App-Anmeldeinformationen und OAuth Informationen. 1. Bestätigen Sie im Abschnitt **Select how the app is managed**, wie Ihre App verwaltet werden soll: 1. **Admin-managed**: Kontoadministratoren fügen die App hinzu und verwalten sie 1. **User-managed**: Einzelne Benutzer fügen die App hinzu und verwalten sie. Die App hat nur Zugriff auf die autorisierten Daten des Benutzers. 1. **App Credentials**: Der Erstellungs-Flow generiert automatisch App-Anmeldeinformationen (Client-ID und Client-Geheimnis) für Ihre App. 1. Richten Sie im Bereich OAuth OAuth Informationen Ihre App ein. 1. **OAuth Weiterleitungs-URL** (erforderlich): Geben Sie Ihre Weiterleitungs-URL oder Ihren Endpunkt ein, um die OAuth Verbindung zwischen Ihrer App und Zoom einzurichten. 1. **Use Strict Mode URL** (optional) 1. **Subdomain check** (optional) 1. **OAuth Zulassungslisten** (erforderlich): Fügen Sie alle eindeutigen Einträge hinzu URLs , die Zoom als gültige Weiterleitungen für Ihre OAuth Flows zulassen soll. 1. Wählen Sie auf der Seite **Scopes** die Zoom-API-Methoden aus, die Ihre App aufrufen darf. Die Bereiche definieren, welche Informationen und Funktionen Ihren Benutzern zur Verfügung stehen. Wählen Sie die folgenden detaillierten Bereiche aus: + user:read:list\$1users:admin + zoom\$1rooms:read:list\$1rooms:admin + group:read:list\$1members:admin + group:read:administrator:admin + group:read:list\$1groups:admin + report:read:admin + role:read:list\$1roles, role:read:list\$1roles:admin Sobald die Bereiche hinzugefügt wurden, wählen Sie **Continue** und die App ist einsatzbereit. Weitere Informationen zum OAuth 2.0-Setup finden Sie unter [Integrationen (OAuth Apps)](https://developers.zoom.us/docs/integrations/). # Konfigurieren von Zoom-Meetings-Verbindungen Zoom Meetings unterstützt den Zuschusstyp AUTHORIZATION\$1CODE für. OAuth2 Die Art des Zuschusses bestimmt, wie mit Zoom Meetings AWS Glue kommuniziert wird, um Zugriff auf Ihre Daten anzufordern. + Diese Art der Gewährung gilt als „dreibeiniges“, OAuth da sie darauf beruht, dass Benutzer zur Authentifizierung des Benutzers an einen Autorisierungsserver eines Drittanbieters weitergeleitet werden. Er wird verwendet, wenn Verbindungen über die Konsole hergestellt werden. AWS Glue Der Benutzer, der eine Verbindung herstellt, muss OAuth zugehörige Informationen wie Client-ID und Client Secret für seine Zoom Meetings-Client-Anwendung angeben. Die AWS Glue Konsole leitet den Benutzer zu Zoom weiter, wo er sich anmelden und den angeforderten Berechtigungen für AWS Glue den Zugriff auf seine Zoom Meetings-Instanz gewähren muss. + Benutzer können sich weiterhin dafür entscheiden, ihre eigene verbundene App in Zoom Meetings zu erstellen und ihre eigene Client-ID und ihr eigenes Client-Geheimnis anzugeben, wenn sie Verbindungen über die AWS Glue Konsole herstellen. In diesem Szenario werden sie weiterhin zu Zoom Meetings weitergeleitet, um sich anzumelden und den Zugriff auf ihre Ressourcen AWS Glue zu autorisieren. + Dieser Gewährungstyp führt zu einem Aktualisierungstoken und einem Zugriffstoken. Das Zugriffstoken ist kurzlebig und kann mithilfe des Aktualisierungstokens automatisch ohne Benutzerinteraktion aktualisiert werden. + Die öffentliche Dokumentation zu Zoom Meetings zur Erstellung einer verbundenen App für den OAuth Autorisierungscodefluss finden Sie unter [Verwenden von OAuth 2.0](https://developers.zoom.us/docs/api/using-zoom-apis/#using-oauth-20). So konfigurieren Sie eine Zoom-Meetings-Verbindung: 1. Erstellen Sie in AWS Secrets Manager ein Secret mit den folgenden Details: 1. Für die kundenseitig verwaltete verbundene App muss das Geheimnis das Verbrauchergeheimnis der verbundenen App mit `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` als Schlüssel enthalten. 1. Hinweis: Sie müssen ein Geheimnis für Ihre Verbindungen in erstellen AWS Glue. 1. Erstellen Sie in AWS Glue Glue Studio eine Verbindung unter **Datenverbindungen**, indem Sie die folgenden Schritte ausführen: 1. Wählen Sie als **Verbindungstyp** Zoom Meetings aus. 1. Geben Sie die Zoom-Meetings-Umgebung an, zu der Sie eine Verbindung herstellen möchten. 1. Wählen Sie die AWS IAM-Rolle aus, die die folgenden Aktionen übernehmen AWS Glue kann und über Berechtigungen verfügt: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "secretsmanager:DescribeSecret", "secretsmanager:GetSecretValue", "secretsmanager:PutSecretValue", "ec2:CreateNetworkInterface", "ec2:DescribeNetworkInterfaces", "ec2:DeleteNetworkInterface" ], "Resource": "*" } ] } ``` ------ 1. Wählen Sie `secretName` die aus, in die Sie für diese Verbindung die Token einfügen AWS Glue möchten. 1. Wählen Sie die Netzwerkoptionen aus, wenn Sie Ihr Netzwerk verwenden möchten. 1. Erteilen Sie der mit Ihrem AWS Glue Job verknüpften IAM-Rolle `secretName` Leserechte. # Aus Zoom-Meetings-Entitäten lesen **Voraussetzung** Ein Zoom-Meetings-Objekt, aus dem gelesen werden soll. Sie benötigen den Objektnamen, z. B. `Group` oder `Zoom Rooms`. **Unterstützte Entitäten für Quelle**: | Entität | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 auswählen“ | Unterstützt Partitionierung | | --- | --- | --- | --- | --- | --- | | Zoom Rooms | Nein | Ja | Nein | Ja | Nein | | Group (Gruppieren) | Nein | Nein | Nein | Ja | Nein | | Gruppenmitglied | Ja | Ja | Nein | Ja | Nein | | Gruppen-Admin | Nein | Ja | Nein | Ja | Nein | | Bericht (täglich) | Ja | Nein | Nein | Ja | Nein | | Rollen | Nein | Nein | Nein | Ja | Nein | | Benutzer | Ja | Ja | Nein | Ja | Nein | **Beispiel:** ``` zoom_read = glueContext.create_dynamic_frame.from_options( connection_type="zoom", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "organization", "API_VERSION": "v2" } ) ``` **Entitäts- und Felddetails von Zoom Meetings**: Zoom Meetings lädt dynamisch die verfügbaren Felder unter der ausgewählten Entität. Je nach Datentyp des Felds werden die folgenden Filteroperatoren unterstützt. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/zoom-meetings-reading-from-entities.html) ## Partitionierung von Abfragen Zoom Meetings unterstützt keine filterbasierte Partitionierung oder datensatzbasierte Partitionierung. # Verbindungsoptionen für Zoom Meetings Im Folgenden sind Verbindungsoptionen für Zoom Meetings aufgeführt: + `ENTITY_NAME` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Der Name der Zoom-Meetings-Entität. Beispiel, `group`. + `API_VERSION` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Version der REST-API von Zoom Meetings, die Sie verwenden möchten. Der Wert wird `v2` sein, da Zoom Meetings derzeit nur Version v2 unterstützt. + `SELECTED_FIELDS` (Liste) – Standard: leer(SELECT \$1). Zum Lesen verwendet. Eine kommagetrennte Liste von Spalten, die Sie für die ausgewählte Entität auswählen möchten. + `FILTER_PREDICATE`(Zeichenfolge) – Standard: leer Zum Lesen verwendet. Muss das Spark-SQL-Format aufweisen. + `QUERY`(Zeichenfolge) – Standard: leer Zum Lesen verwendet. Vollständige Spark-SQL-Abfrage. # Einschränkungen für Zoom Meetings Im Folgenden finden Sie Einschränkungen oder Hinweise für Zoom Meetings: + Zoom Meetings unterstützt „orderby“ nicht. + Zoom Meetings unterstützt keine filterbasierte Partitionierung, da es kein Feld gibt, das die erforderlichen Kriterien erfüllen kann. + Zoom Meetings unterstützt keine datensatzbasierte Partitionierung, da das Paginierungslimit und die Offset-basierte Paginierung nicht unterstützt werden.