Cerca utenti

Versione 4.0.23.2

Cerca utenti

Restituisce tutti i record degli utenti* che corrispondono ai criteri di ricerca specificati.

Se vengono forniti più parametri di ricerca e filter_or è FALSO o non specificato, i parametri di ricerca vengono combinati in un'operazione AND logica. Verranno restituite solo le righe che corrispondono a tutti i criteri del parametro di ricerca.

Se filter_or è TRUE, più parametri di ricerca vengono combinati in un'operazione OR logica. I risultati includeranno le righe che corrispondono a uno qualsiasi dei criteri di ricerca.

I parametri di ricerca della stringa utilizzano una corrispondenza senza distinzione tra maiuscole e minuscole. I parametri di ricerca della stringa possono contenere % e "_" come pattern di corrispondenza con caratteri SQL SQL. example="dan%" corrisponderà a "danger" e "Danzig", ma non a "David" example="D_m%" corrisponderà a "Damage" e "dump"

I parametri di ricerca interi possono accettare un unico valore o un elenco di valori separato da virgole. I diversi valori verranno combinati in un'operazione OR logica. I risultati corrisponderanno ad almeno uno dei valori specificati.

La maggior parte dei parametri di ricerca può accettare "IS NULL" e "NOT NULL" come espressioni speciali per soddisfare o escludere (rispettivamente) le righe in cui la colonna è null.

I parametri di ricerca booleana accettano solo i valori "true" e "false".

(*) I risultati vengono sempre filtrati in base al livello di informazioni che il chiamante può visualizzare. Gli amministratori di Looker possono vedere tutti i dettagli degli utenti; gli utenti normali in un sistema aperto possono vedere i nomi di altri utenti, ma nessun dettaglio; gli utenti normali in un sistema chiuso possono vedere solo i nomi di altri utenti che sono membri dello stesso gruppo dell'utente.

Richiesta

GET /users/search
Tipo di dati
Descrizione
Richiesta
HTTPRequest
della query
Query HTTP
Espandi definizione HTTPQuery in corso...
campi
string
Includi solo questi campi nella risposta
pagina
integer
OBSOLETO. Utilizza invece il limite e l'offset. Restituisce solo la pagina N dei risultati impaginati
per_pagina
integer
OBSOLETO. Utilizza invece il limite e l'offset. Restituisce N righe di dati per pagina
limite
integer
Numero di risultati da restituire. (utilizzato con offset e ha la priorità sulle pagine e per_pagina)
offset
integer
Numero di risultati da ignorare prima di restituirne uno. (utilizzato con limite e ha la priorità sulle pagine e per_pagina)
ordina
string
Campi in base ai quali ordinare.
id
string
Associa ID utente.
first_name
string
Nome corrispondenza.
last_name
string
Cognome corrispondenza.
look_looker_dipendente
boolean
Cercare gli account utente associati ai dipendenti Looker
incorpora_utente
boolean
Cerca solo utenti incorporati
email
string
Cerca l'utente con questo indirizzo email
è_disattivato
boolean
Cercare gli account utente disattivati
filtro_o
boolean
Combinare determinati criteri di ricerca in un'espressione booleana OR
id_metadati_contenuti
string
Cerca utenti che hanno accesso a questo elemento content_metadata
group_id
string
Cerca utenti che sono membri diretti di questo gruppo

Risposta

200: Utenti corrispondenti.

Tipo di dati
Descrizione
(array)
Utente[]
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
url_avatar
string
URL dell'immagine dell'avatar (potrebbe essere generico)
URL_avatar_senza_dimensioni
string
L'URL per l'immagine avatar (può essere generico) non specifica la dimensione
credenziali_api3
Espandi definizione CredentialsApi3...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id
string
ID univoco
client_id
string
Client_id della chiave API
creata_alle
string
Timestamp per la creazione di questa credenziale
è_disattivato
boolean
Questa credenziale è stata disattivata?
tipo
string
Nome breve per il tipo di questo tipo di credenziale
url
string
Link per acquistare questo articolo
credenziali_email
Credenziali di accesso tramite email/password
Espandi definizione CredentialsEmail...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
creata_alle
string
Timestamp per la creazione di questa credenziale
email
string
Indirizzo email utilizzato per l'accesso dell'utente
ripristino_password_forzata_tramite_accesso_successivo
boolean
Obbliga gli utenti a cambiare la password all'accesso successivo
ID_utente
string
ID univoco dell'utente
è_disattivato
boolean
Questa credenziale è stata disattivata?
registrato
string
Timestamp per l'accesso più recente tramite credenziale
url_reset_password
string
URL con token segreto utilizzabile una sola volta e utilizzabile dall'utente per reimpostare la password
url_configurazione_account
string
URL con token segreto monouso che l'utente può utilizzare per configurare l'account
tipo
string
Nome breve per il tipo di questo tipo di credenziale
url
string
Link per acquistare questo articolo
url_utente
string
Link per trovare l'utente
credenziale_incorporamento
Espandi definizione Credenziali incorporate...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
creata_alle
string
Timestamp per la creazione di questa credenziale
id_gruppo_esterno
string
ID dello strumento di incorporamento per un gruppo a cui questo utente è stato aggiunto durante l'accesso più recente
id_utente_esterno
string
ID univoco dell'incorporamento per l'utente
id
string
ID univoco
è_disattivato
boolean
Questa credenziale è stata disattivata?
registrato
string
Timestamp per l'accesso più recente tramite credenziale
tipo
string
Nome breve per il tipo di questo tipo di credenziale
url
string
Link per acquistare questo articolo
credenziali_google
Credenziali di autenticazione Google
Espandi definizione Credenziali di Google...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
creata_alle
string
Timestamp per la creazione di questa credenziale
domain
string
Dominio Google
email
string
Indirizzo email
ID_utente_google
string
ID univoco di Google per questo utente
è_disattivato
boolean
Questa credenziale è stata disattivata?
registrato
string
Timestamp per l'accesso più recente tramite credenziale
tipo
string
Nome breve per il tipo di questo tipo di credenziale
url
string
Link per acquistare questo articolo
credenziali_ldap
Credenziali LDAP
Espandi definizione CredentialsLDAP...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
creata_alle
string
Timestamp per la creazione di questa credenziale
email
string
Indirizzo email
è_disattivato
boolean
Questa credenziale è stata disattivata?
ldap_dn
string
Nome distinto LDAP per questo utente (dall'ultimo accesso)
ID ldap
string
ID univoco LDAP per questo utente
registrato
string
Timestamp per l'accesso più recente tramite credenziale
tipo
string
Nome breve per il tipo di questo tipo di credenziale
url
string
Link per acquistare questo articolo
credenziali_looker_aperte
Credenziali LookerOpenID. Utilizzati per l'accesso da parte degli analisti di Looker
Espandi definizione CredentialsLookerOpenid...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
creata_alle
string
Timestamp per la creazione di questa credenziale
email
string
Indirizzo email utilizzato per l'accesso dell'utente
è_disattivato
boolean
Questa credenziale è stata disattivata?
registrato
string
Timestamp per l'accesso più recente tramite credenziale
accesso_ip
string
Indirizzo IP del client per l'accesso più recente utilizzando le credenziali
tipo
string
Nome breve per il tipo di questo tipo di credenziale
url
string
Link per acquistare questo articolo
url_utente
string
Link per trovare l'utente
credenziali_oidc
Credenziali di autenticazione OpenID Connect
Espandi definizione CredentialsOIDC...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
creata_alle
string
Timestamp per la creazione di questa credenziale
email
string
Indirizzo email
è_disattivato
boolean
Questa credenziale è stata disattivata?
registrato
string
Timestamp per l'accesso più recente tramite credenziale
id_utente_oidc
string
ID univoco dell'OP OIDC per questo utente
tipo
string
Nome breve per il tipo di questo tipo di credenziale
url
string
Link per acquistare questo articolo
credenziali_saml
Credenziali di autenticazione Saml
Espandi definizione CredentialsSaml...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
creata_alle
string
Timestamp per la creazione di questa credenziale
email
string
Indirizzo email
è_disattivato
boolean
Questa credenziale è stata disattivata?
registrato
string
Timestamp per l'accesso più recente tramite credenziale
ID_utente_saml
string
L'ID univoco dell'IdP Saml per questo utente
tipo
string
Nome breve per il tipo di questo tipo di credenziale
url
string
Link per acquistare questo articolo
credenziali_totp
Credenziali a due fattori
Espandi definizione CredentialsTotp...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
creata_alle
string
Timestamp per la creazione di questa credenziale
è_disattivato
boolean
Questa credenziale è stata disattivata?
tipo
string
Nome breve per il tipo di questo tipo di credenziale
verificati
boolean
Utente verificato
url
string
Link per acquistare questo articolo
nome_visualizzazione
string
Nome completo da visualizzare (disponibile solo se sono impostati sia nome che cognome)
email
string
Indirizzo email
id_spazio_di_gruppo_incorporamento
string
(DEPRECATO) (solo incorporamento) ID dello spazio di gruppo dell'utente in base all'external_group_id specificato facoltativamente durante l'incorporamento dell'accesso dell'utente
first_name
string
Nome
id_gruppo
stringa[]
ID_cartella_home
string
Stringa ID per la home directory dell'utente
id
string
ID univoco
è_disattivato
boolean
L'account è stato disattivato
last_name
string
Cognome
impostazioni internazionali
string
Impostazioni internazionali preferite dall'utente. Le impostazioni internazionali degli utenti hanno la precedenza sulle impostazioni internazionali predefinite di Looker. Le impostazioni internazionali determinano la lingua delle stringhe di visualizzazione e la formattazione di data e numerico nelle risposte dell'API. La stringa di impostazioni internazionali deve essere un codice lingua di due lettere o una combinazione di codice lingua e codice regione, ad esempio "en" o "en-US".
versioni_looker
stringa[]
model_dir_validated
boolean
L'area di lavoro di sviluppo dell'utente è stata controllata per la presenza di progetti di produzione applicabili
id_cartella_personale
string
ID della cartella personale dell'utente
presunto_dipendente
boolean
L'utente è stato identificato come dipendente di Looker
id_ruolo
stringa[]
sessions
Espandi definizione sessione...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id
string
ID univoco
indirizzo_IP
string
Indirizzo IP dell'utente quando è stata avviata questa sessione
browser
string
Tipo di browser dell'utente
sistema_operativo
string
Sistema operativo dell'utente
città
string
Componente della città della località dell'utente (derivato dall'indirizzo IP)
state
string
Stato componente della località dell'utente (derivato dall'indirizzo IP)
paese
string
Componente del paese della località dell'utente (derivato dall'indirizzo IP)
credenziali_tipo
string
Tipo di credenziali utilizzate per il logging in questa sessione
esteso_a
string
Ora in cui l'utente ha prolungato l'ultima sessione
numero_prolungato
integer
Numero di volte in cui la sessione è stata estesa
ID_utente_sudo
string
Utente effettivo nel caso in cui questa sessione rappresenta un utente che esegue un'altra azione
creata_alle
string
Ora di inizio di questa sessione
scade_in
string
Ora alla scadenza di questa sessione
url
string
Link per acquistare questo articolo
stato_ui
oggetto
Dizionario per utente delle informazioni sullo stato non documentate di proprietà della UI di Looker.
look_looker_dipendente
boolean
L'utente è identificato come un dipendente di Looker che è stato verificato tramite l'autenticazione aziendale di Looker.
roles_external__managed
boolean
I ruoli utente sono gestiti da una directory esterna, come SAML o LDAP, e non possono essere modificati direttamente.
ruoli_direct_direct
boolean
All'utente può essere assegnato direttamente un ruolo.
allow_normal_group_membership
boolean
L'utente può essere membro diretto di un normale gruppo Looker.
allow_roles_from_normal_groups
boolean
L'utente può ereditare i ruoli da un normale gruppo Looker.
id_cartella_incorporamento
string
(Solo incorporamento) ID della cartella di gruppo dell'utente in base all'external_group_id, specificato facoltativamente durante l'incorporamento dell'accesso utente
url
string
Link per acquistare questo articolo

400: Richiesta errata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

404: Non trovata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

Esempi

Python

https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/add_users_to_group_from_csv.py
https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/cloud-function-user-provision/main.py
https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/disable_users_by_email.py
https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/transfer_all_schedules.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py

TypeScript

https://github.com/looker-open-source/sdk-codegen/blob/main/examples/typescript/sudoAsUser.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/hackathon/src/models/Hacker.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts

Kotlin

https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestSmoke.kt

Swift

https://github.com/looker-open-source/sdk-codegen/blob/main/swift/looker/Tests/lookerTests/methodsTests.swift
https://github.com/looker-open-source/sdk-codegen/blob/main/swift/looker/Tests/lookerTests/smokeTests.swift