Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Un modificatore di ambito restringe un ambito API a un sottoinsieme delle sue operazioni. Per aggiungere un modificatore, aggiungalo al nome dell'ambito dopo i due punti, ad esempio clusters:read. Un ambito senza modificatore consente ogni operazione all'interno dell'ambito.
Puoi utilizzare i modificatori di ambito in:
- Token di accesso personali con ambito definito
- Segreti OAuth con ambito definito per i service principal
- Il parametro
scopedi una richiesta di token OAuth, sia che tu ti autentichi come utente, come principale di servizio o scambi un token di provider di identità con federazione di identità del carico di lavoro
Per l'elenco completo degli ambiti e delle operazioni dell'API coperte da ciascuno di essi, consulta API scopes.
Modificatori disponibili
-
:read: Consente solo le operazioni di lettura dell'ambito (le richiesteGETeHEAD). Ad esempio,clusters:readpermette di elencare e ottenere cluster ma non di crearli, modificare o cancellarli. -
:restricted-query: Consente query SQL di sola lettura. Questo modificatore si applica solo all'ambitosql. Un token consql:restricted-querypuò eseguire query comeSELECTeDESCRIBEcon l'API di esecuzione delle istruzioni e i driver e connettori SQL. Non può chiamare altre API SQL, ad esempio per elencare i SQL warehouse. Le istruzioni che modificano oggetti o dati non funzionano:- Le istruzioni che creano, modificano o eliminano oggetti, come
CREATE TABLEeDROP TABLE, falliscono con[OP_NOT_SUPPORTED_READ_ONLY] ... is not supported in read-only session mode. SQLSTATE: 42KD1. - Le istruzioni che modificano dati, come
INSERTeUPDATE, falliscono con[INSUFFICIENT_PERMISSIONS] Insufficient privileges, anche su tabelle di tuo possesso.
- Le istruzioni che creano, modificano o eliminano oggetti, come
Per combinare i modificatori, aggiungi entrambi: sql:read:restricted-query consente le sql operazioni di lettura dell'ambito, come l'elenco dei magazzini SQL e le query di sola lettura.
Seleziona un livello di accesso nell'interfaccia utente
Quando generi un token di accesso personale o un segreto OAuth nell'interfaccia utente dello spazio di lavoro, dopo aver aggiunto un ambito, seleziona il suo livello di accesso. Il livello di accesso imposta il modificatore:
| Livello di accesso | Ambito autorizzato |
|---|---|
| Leggi | <scope>:read |
| Leggi + Scrivi |
<scope> (nessun modificatore) |
Query limitata (sql solo) |
sql:restricted-query |
Lettura + Query limitata (sql solo) |
sql:read:restricted-query |
Lettura + Query Restringita + Scrittura (sql solo) |
sql (nessun modificatore) |
Usa i modificatori con i token di accesso personali
Con l'API Token, includere ogni ambito con i suoi modificatori come un elemento dell'array scopes . I token di accesso personali non supportano all-apis:read. Per concedere l'accesso completo allo spazio di lavoro, utilizza un array vuoto scopes (lo scope all-apis). Vedere Token di accesso personali con ambito.
Usa i modificatori con OAuth
Puoi associare un segreto OAuth di service principal a scope con modificatori, e puoi richiedere un token di accesso OAuth con scope modificatori. Un token di accesso non può superare l'ambito del segreto da cui è stato coniato, tranne nel caso di un segreto con l'ambito authentication. Vedi segreti OAuth con ambito definito. OAuth accetta anche all-apis:read, che consente operazioni di lettura su ogni API per cui il principal è autorizzato.
Per richiedere un token con modificatori, elenca gli ambiti nel scope parametro della richiesta del token, separati da spazi. Nell'URL di autorizzazione del flusso utente-macchina, separare gli ambiti con + invece.