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à.
# Connessione a Zoom Meetings
Zoom Meetings è una piattaforma di videoconferenza basata su cloud che può essere usata per videoconferenze, audioconferenze, webinar, registrazioni delle riunioni e chat dal vivo.
**Topics**
+ [AWS Glue supporto per Zoom Meetings](zoom-meetings-support.md)
+ [Policy contenenti le operazioni API per creare e utilizzare le connessioni](zoom-meetings-configuring-iam-permissions.md)
+ [Configurazione di Zoom Meetings](zoom-meetings-configuring.md)
+ [Configurazione dell'app client Zoom Meetings](zoom-meetings-configuring-client-app.md)
+ [Configurazione delle connessioni di Zoom Meetings](zoom-meetings-configuring-connections.md)
+ [Lettura da entità Zoom Meetings](zoom-meetings-reading-from-entities.md)
+ [Opzioni di connessione Zoom Meetings](zoom-meetings-connection-options.md)
+ [Limitazioni Zoom Meetings](zoom-meetings-limitations.md)
# AWS Glue supporto per Zoom Meetings
AWS Glue supporta Zoom Meetings come segue:
**Supportato come origine?**
Sì. Puoi utilizzare i job AWS Glue ETL per interrogare i dati da Zoom Meetings.
**Supportato come destinazione?**
No.
**Versioni dell'API Zoom Meetings supportate**
Sono supportate le seguenti versioni dell'API Zoom Meetings:
+ v2
# Policy contenenti le operazioni API per creare e utilizzare le connessioni
La seguente policy di esempio descrive le autorizzazioni AWS IAM richieste per la creazione e l'utilizzo delle connessioni. Se si sta creando un nuovo ruolo, creare una policy che contenga quanto segue:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
In alternativa, se non desideri utilizzare il metodo precedente, utilizza le seguenti policy IAM gestite:
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Garantisce l'accesso alle risorse che AWS Glue i vari processi richiedono per l'esecuzione per conto dell'utente. Queste risorse includono AWS Glue Amazon S3, IAM, CloudWatch Logs e Amazon. EC2 Se segui la convenzione di denominazione delle risorse specificata in questa politica, AWS Glue i processi dispongono delle autorizzazioni richieste. Questa policy è in genere collegata ai ruoli specificati quando si definiscono crawler, processi ed endpoint di sviluppo.
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Concede l'accesso completo alle AWS Glue risorse quando un'identità a cui è allegata la policy utilizza la AWS console di gestione. Se si segue la convenzione per la denominazione per le risorse specificate nella policy, gli utenti hanno la piena funzionalità della console. Questa policy è in genere associata agli utenti della AWS Glue console.
# Configurazione di Zoom Meetings
Prima di poter AWS Glue utilizzare il trasferimento di dati da Zoom Meetings, devi soddisfare questi requisiti:
## Requisiti minimi
I requisiti minimi sono i seguenti:
+ Possedere un account Zoom Meetings.
+ L'account Zoom è abilitato all'accesso tramite API.
+ Hai creato un' OAuth2 app nel tuo account Zoom Meetings. Questa integrazione fornisce le credenziali AWS Glue utilizzate per accedere ai dati in modo sicuro quando effettua chiamate autenticate al vostro account. Per ulteriori informazioni, consulta [Configurazione dell'app client Zoom Meetings](zoom-meetings-configuring-client-app.md).
Se soddisfi questi requisiti, sei pronto per connetterti AWS Glue al tuo account Zoom Meetings. Per le connessioni tipiche non sono necessarie altre azioni in Zoom Meetings.
# Configurazione dell'app client Zoom Meetings
1. Accedere a Zoom App Marketplace.
1. Scegliere **Sviluppo** > **Crea app**.
1. Scegli **General App** per un'app basata su OAuth 2.0.
1. Nella pagina **Informazioni di base**, aggiungi o aggiorna le informazioni sull'app, come il nome dell'app, la modalità di gestione dell'app, le credenziali dell'app e le OAuth informazioni.
1. Nella sezione **Seleziona la modalità di gestione dell'app**, confermare come si desidera che venga gestita l'app:
1. **Gestita dall'amministratore**: gli amministratori dell'account aggiungono e gestiscono l'app
1. **Gestita dall'utente**: i singoli utenti aggiungono e gestiscono l'app. L'app ha accesso solo ai dati autorizzati dell'utente.
1. **Credenziali dell'app**: il flusso di compilazione genera automaticamente le credenziali dell'app (ID client e segreto del client) per l'app.
1. Nella sezione OAuth Informazioni, configura OAuth la tua app.
1. **OAuth URL di reindirizzamento** (obbligatorio): inserisci l'URL o l'endpoint di reindirizzamento da configurare OAuth tra l'app e Zoom.
1. **Usare l'URL in modalità rigorosa** (opzionale)
1. **Controllo del sottodominio** (opzionale)
1. **OAuth elenchi consentiti** (obbligatorio): aggiungi eventuali reindirizzamenti univoci URLs che Zoom dovrebbe consentire come reindirizzamenti validi per i tuoi flussi. OAuth
1. Nella pagina **Ambiti**, selezionare i metodi dell'API Zoom che l'app è autorizzata a chiamare. Gli ambiti definiscono quali informazioni e funzionalità sono disponibili per l'utente. Selezionare i seguenti ambiti granulari:
+ 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
Una volta aggiunti gli ambiti, scegliere **Continua** e l'app è pronta per l'uso.
Per ulteriori informazioni sulla configurazione OAuth 2.0, consulta [Integrazioni (app) OAuth ](https://developers.zoom.us/docs/integrations/).
# Configurazione delle connessioni di Zoom Meetings
Zoom Meetings supporta il tipo di concessione AUTHORIZATION\$1CODE per. OAuth2 Il tipo di concessione determina il modo in cui AWS Glue comunica con Zoom Meetings per richiedere l'accesso ai tuoi dati.
+ Questo tipo di concessione è considerato «a tre gambe» in OAuth quanto si basa sul reindirizzamento degli utenti a un server di autorizzazione di terze parti per autenticare l'utente. Viene utilizzato durante la creazione di connessioni tramite la console. AWS Glue L'utente che crea una connessione deve fornire informazioni OAuth correlate come Client ID e Client Secret per la propria applicazione client Zoom Meetings. La AWS Glue console reindirizzerà l'utente a Zoom, dove l'utente deve effettuare il login e consentire AWS Glue le autorizzazioni richieste per accedere alla propria istanza di Zoom Meetings.
+ Gli utenti possono comunque scegliere di creare la propria app connessa in Zoom Meetings e fornire il proprio ID cliente e il segreto del client durante la creazione di connessioni tramite la AWS Glue console. In questo scenario, verranno comunque reindirizzati a Zoom Meetings per accedere e autorizzare l'accesso AWS Glue alle proprie risorse.
+ Questo tipo di concessione genera un token di aggiornamento e un token di accesso. Il token di accesso dura poco tempo e può essere aggiornato automaticamente senza l'interazione dell'utente utilizzando il token di aggiornamento.
+ Per la documentazione pubblica di Zoom Meetings sulla creazione di un'app connessa per il OAuth flusso del codice di autorizzazione, consulta [Using OAuth ](https://developers.zoom.us/docs/api/using-zoom-apis/#using-oauth-20) 2.0.
Per configurare una connessione di Zoom Meetings:
1. In AWS Secrets Manager, crea un segreto con i seguenti dettagli:
1. Per le app connesse gestite dal cliente: il segreto deve contenere l'app connessa Consumer Secret con `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` come chiave.
1. Nota: devi creare un segreto per le tue connessioni in AWS Glue.
1. In AWS Glue Glue Studio, crea una connessione in **Connessioni dati** seguendo i passaggi seguenti:
1. In **Tipo di connessione**, selezionare Zoom Meetings.
1. Fornire l'ambiente Zoom Meetings a cui ci si desidera connettere.
1. Seleziona il ruolo AWS IAM che AWS Glue può assumere e dispone delle autorizzazioni per le seguenti azioni:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Seleziona quello `secretName` che desideri utilizzare per questa connessione per AWS Glue inserire i token.
1. Selezionare le opzioni di rete se si desidera utilizzare la propria rete.
1. Concedi il permesso di lettura `secretName` al ruolo IAM associato al tuo AWS Glue lavoro.
# Lettura da entità Zoom Meetings
**Prerequisito**
Un oggetto di Zoom Meetings da cui si desidera leggere. È necessario il nome dell'oggetto, come `Group` o `Zoom Rooms`.
**Entità supportate come origine**:
| Entità | Può essere filtrato | Supporta limite | Supporta Ordina per | Supporta Seleziona \$1 | Supporta il partizionamento |
| --- | --- | --- | --- | --- | --- |
| Zoom Rooms | No | Sì | No | Sì | No |
| Gruppo | No | No | No | Sì | No |
| Membro del gruppo | Sì | Sì | No | Sì | No |
| Amministratore del gruppo | No | Sì | No | Sì | No |
| Rapporto (giornaliero) | Sì | No | No | Sì | No |
| Roles | No | No | No | Sì | No |
| Utenti | Sì | Sì | No | Sì | No |
**Esempio**:
```
zoom_read = glueContext.create_dynamic_frame.from_options(
connection_type="zoom",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "organization",
"API_VERSION": "v2"
}
)
```
**Dettagli dell'entità e del campo di Zoom Meetings**:
Zoom Meetings carica dinamicamente i campi disponibili nell'entità selezionata. A seconda del tipo di dati di campo, supporta i seguenti operatori di filtro.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/zoom-meetings-reading-from-entities.html)
## Query di partizionamento
Zoom Meetings non supporta il partizionamento basato su filtri ov quello basato su record.
# Opzioni di connessione Zoom Meetings
Le seguenti sono le opzioni di connessione per Zoom Meetings:
+ `ENTITY_NAME`(String): (obbligatorio) utilizzato per la lettura. Il nome dell'entità Zoom Meetings. Ad esempio, `group`.
+ `API_VERSION`(String): (obbligatorio) utilizzato per la lettura. La versione di Zoom Meetings Rest API che si desidera utilizzare. Il valore sarà `v2`, poiché Zoom Meetings attualmente supporta solo la versione v2.
+ `SELECTED_FIELDS`(List): predefinito: vuoto (SELECT \$1). Utilizzato per la lettura. Un elenco di colonne separate da virgole che si desidera selezionare per l'entità selezionata.
+ `FILTER_PREDICATE`(Stringa): predefinito: vuoto. Utilizzato per la lettura. Dev'essere in formato Spark SQL.
+ `QUERY`(Stringa): predefinito: vuoto. Utilizzato per la lettura. Query Spark SQL completa.
# Limitazioni Zoom Meetings
Di seguito sono riportate le limitazioni o le note per Zoom Meetings:
+ Zoom Meetings non supporta orderby.
+ Zoom Meetings non supporta il partizionamento basato su filtri perché non esiste un campo in grado di soddisfare i criteri richiesti.
+ Zoom Meetings non supporta il partizionamento basato su record perché il limite di impaginazione e l'impaginazione basata sull'offset non sono supportati.