Rechercher des utilisateurs

Version 4.0.23.2

Rechercher des utilisateurs

Renvoie tous les enregistrements utilisateur* correspondant aux critères de recherche indiqués.

Si plusieurs paramètres de recherche sont fournis et que filter_or est défini sur FALSE ou non spécifié, les paramètres de recherche sont combinés dans une opération logique AND. Seules les lignes correspondant à tous les critères de recherche sont renvoyées.

Si filter_or est VRAI, plusieurs paramètres de recherche sont combinés dans une opération logique OU. Les résultats comprennent les lignes qui correspondent à n'importe lequel des critères de recherche.

Les paramètres de recherche de chaîne utilisent une correspondance non sensible à la casse. Les paramètres de recherche de chaîne peuvent contenir % et '_' en tant qu'expressions génériques de correspondance de type SQL like. example="dan%" correspond à "danger" et "Danzig", mais pas "David", example="D_m%" correspond à "Damage" et "dump"

Les paramètres de recherche de nombres entiers peuvent accepter une valeur unique ou une liste de valeurs séparées par une virgule. Les différentes valeurs seront combinées sous la forme d'une opération logique OU. Les résultats correspondront à au moins une des valeurs données.

La plupart des paramètres de recherche peuvent accepter "IS NULL" et "NOT NULL" en tant qu'expressions spéciales pour faire correspondre ou exclure (respectivement) les lignes dont la colonne est nulle.

Les paramètres de recherche booléens n'acceptent que les valeurs "true" et "false".

(*) Les résultats sont toujours filtrés en fonction du niveau d'information que l'appelant est autorisé à voir. Les administrateurs Looker peuvent voir toutes les informations utilisateur ; les utilisateurs normaux d'un système ouvert peuvent voir le nom d'autres utilisateurs, mais pas de détails ; les utilisateurs normaux d'un système fermé ne peuvent voir que le nom d'autres utilisateurs membres du même groupe que l'utilisateur.

Demande

GET /users/search
Type de données
Description
Demande
HTTPRequest
query
Requête HTTP
Développer la définition de la requête HTTP...
champs
string
Inclure uniquement ces champs dans la réponse
page
integer
OBSOLÈTE. Utilisez plutôt la limite et le décalage. Afficher seulement la page N des résultats paginés
par_page
integer
OBSOLÈTE. Utilisez plutôt la limite et le décalage. Afficher N lignes de données par page
limite
integer
Nombre de résultats à afficher. (utilisé avec un décalage et qui est prioritaire sur la page et par_page)
offset
integer
Nombre de résultats à ignorer avant d'en renvoyer. (utilisé avec une limite et prévaut sur la page et par_page)
tri
string
Champs selon lesquels effectuer le tri.
id
string
ID utilisateur correspondant.
first_name
string
Correspond au prénom.
last_name
string
Correspond au nom.
employé_Looker_cherché
booléen
Rechercher des comptes utilisateur associés aux employés Looker
intégrer_utilisateur
booléen
Rechercher uniquement les utilisateurs intégrés
e-mail
string
Rechercher l'utilisateur avec cette adresse e-mail
est_désactivé
booléen
Rechercher des comptes utilisateur désactivés
filtre_ou
booléen
Combiner les critères de recherche indiqués dans une expression booléenne OU
id_métadonnées_contenu
string
Rechercher des utilisateurs ayant accès à cet élément content_metadata
group_id
string
Rechercher des utilisateurs directs de ce groupe

Réponse

200: mise en correspondance des utilisateurs.

Type de données
Description
(tableau)
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
avatar
string
URL de l'avatar (peut être générique)
avatar_url_sans_taille
string
URL de l'avatar (peut être générique) et ne spécifie pas la taille
identifiants_api3
Développer la définition de CredentialsApi3...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
id
string
Identifiant unique
client_id
string
Clé API : client_id
créé le
string
Horodatage de création de cet identifiant.
est_désactivé
booléen
Cet identifiant a-t-il été désactivé ?
type
string
Nom court pour le type de ce type d'identifiants
url
string
Lien pour obtenir cet élément
identifiants_e-mail
CredentialsEmail (Adresse e-mail d'identification)
Identifiants de connexion par e-mail/mot de passe
Développer la définition de l'adresse e-mail CredentialsEmail...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
créé le
string
Horodatage de création de cet identifiant.
e-mail
string
Adresse e-mail utilisée pour la connexion de l'utilisateur
"force_password_reset_at_next_login"
booléen
Obliger l'utilisateur à modifier son mot de passe à sa prochaine connexion
user_id
string
Identifiant unique de l'utilisateur
est_désactivé
booléen
Cet identifiant a-t-il été désactivé ?
connecté
string
Code temporel de la connexion la plus récente à l'aide des identifiants
URL_de_réinitialisation_du_mot_de_passe
string
URL avec jeton secret à usage unique que l'utilisateur peut utiliser pour réinitialiser le mot de passe
URL_Configuration_du_compte
string
URL avec jeton secret à usage unique que l'utilisateur peut utiliser pour configurer le compte
type
string
Nom court pour le type de ce type d'identifiants
url
string
Lien pour obtenir cet élément
URL utilisateur
string
Lien pour obtenir cet utilisateur
identifiants_embed
Développer la définition CredentialsEmbed...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
créé le
string
Horodatage de création de cet identifiant.
id_groupe_externe
string
ID de l'intégrateur pour un groupe auquel cet utilisateur a été ajouté lors de la dernière connexion
id_utilisateur_externe
string
ID unique de l'intégrateur pour l'utilisateur
id
string
Identifiant unique
est_désactivé
booléen
Cet identifiant a-t-il été désactivé ?
connecté
string
Code temporel de la connexion la plus récente à l'aide des identifiants
type
string
Nom court pour le type de ce type d'identifiants
url
string
Lien pour obtenir cet élément
identifiants_google
Identifiants d'authentification Google
Développer la définition d'CredentialsGoogle...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
créé le
string
Horodatage de création de cet identifiant.
domaine
string
Domaine Google
e-mail
string
Adresse e-mail
id_utilisateur_google
string
Identifiant unique Google pour cet utilisateur
est_désactivé
booléen
Cet identifiant a-t-il été désactivé ?
connecté
string
Code temporel de la connexion la plus récente à l'aide des identifiants
type
string
Nom court pour le type de ce type d'identifiants
url
string
Lien pour obtenir cet élément
identifiants_ldap
Identifiants LDAP
Développer la définition de CredentialsLDAP...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
créé le
string
Horodatage de création de cet identifiant.
e-mail
string
Adresse e-mail
est_désactivé
booléen
Cet identifiant a-t-il été désactivé ?
ldap_dn
string
Nom distinctif LDAP pour cet utilisateur (depuis la dernière connexion)
ldap_id,
string
Identifiant unique LDAP pour cet utilisateur
connecté
string
Code temporel de la connexion la plus récente à l'aide des identifiants
type
string
Nom court pour le type de ce type d'identifiants
url
string
Lien pour obtenir cet élément
identifiants_looker_openid
Identifiants LookerOpenID. Utilisé pour la connexion par les analystes Looker
Développer la définition CredentialsLookerOpenid...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
créé le
string
Horodatage de création de cet identifiant.
e-mail
string
Adresse e-mail utilisée pour la connexion de l'utilisateur
est_désactivé
booléen
Cet identifiant a-t-il été désactivé ?
connecté
string
Code temporel de la connexion la plus récente à l'aide des identifiants
IP_connectée
string
Adresse IP du client pour la connexion la plus récente à l'aide des identifiants
type
string
Nom court pour le type de ce type d'identifiants
url
string
Lien pour obtenir cet élément
URL utilisateur
string
Lien pour obtenir cet utilisateur
identifiants_oidc
Identifiants d'authentification OpenID Connect
Développer la définition de CredentialsOIDC...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
créé le
string
Horodatage de création de cet identifiant.
e-mail
string
Adresse e-mail
est_désactivé
booléen
Cet identifiant a-t-il été désactivé ?
connecté
string
Code temporel de la connexion la plus récente à l'aide des identifiants
ID utilisateur_oidc
string
Identifiant unique de l'interopérabilité OIDC pour cet utilisateur
type
string
Nom court pour le type de ce type d'identifiants
url
string
Lien pour obtenir cet élément
identifiants_saml
Identifiants d'authentification identiques
Développer la définition de CredentialsSaml...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
créé le
string
Horodatage de création de cet identifiant.
e-mail
string
Adresse e-mail
est_désactivé
booléen
Cet identifiant a-t-il été désactivé ?
connecté
string
Code temporel de la connexion la plus récente à l'aide des identifiants
ID_utilisateur_ SAML
string
ID unique du même fournisseur d'identité pour cet utilisateur
type
string
Nom court pour le type de ce type d'identifiants
url
string
Lien pour obtenir cet élément
identifiants_Totp
Identifiants à deux facteurs
Développer la définition de CredentialsTotp...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
créé le
string
Horodatage de création de cet identifiant.
est_désactivé
booléen
Cet identifiant a-t-il été désactivé ?
type
string
Nom court pour le type de ce type d'identifiants
validé
booléen
L'utilisateur a été validé
url
string
Lien pour obtenir cet élément
display_name
string
Nom complet à afficher (disponible uniquement si prénom et nom)
e-mail
string
Adresse e-mail
ID_espace_groupe_intégration
string
(OBSOLÈTE) (Intégration uniquement) ID de l'espace de groupe de l'utilisateur basé sur l'ID externe du groupe (facultatif) spécifié lors de la connexion de l'utilisateur intégré
first_name
string
Prénom
identifiants_groupe
chaîne[]
id_dossier_accueil
string
Chaîne du dossier d'accueil de l'utilisateur
id
string
Identifiant unique
est_désactivé
booléen
Le compte a été désactivé
last_name
string
Nom
locale
string
Paramètres régionaux préférés de l'utilisateur. Les paramètres régionaux de l'utilisateur sont prioritaires sur les paramètres régionaux par défaut de Looker. Les paramètres régionaux déterminent la langue des chaînes d'affichage, ainsi que la mise en forme des dates et des valeurs numériques dans les réponses de l'API. La chaîne des paramètres régionaux doit être un code de langue à deux lettres ou une combinaison de codes de langue et de code régional: "en" ou "en-US", par exemple.
versions_looker
chaîne[]
modèles_dir_validé
booléen
La présence des projets de production applicables dans l'espace de travail de l'utilisateur a été vérifiée
id_dossier_personnel
string
ID du dossier personnel de l'utilisateur
présumé_looker_employé
booléen
L'utilisateur est identifié comme employé de Looker
id_rôles
chaîne[]
sessions
Développer la définition de session...
peut
objet
Opérations que l'utilisateur actuel peut effectuer sur cet objet
id
string
Identifiant unique
ip_address
string
Adresse IP de l'utilisateur lors du lancement de cette session
browser
string
Type de navigateur de l'utilisateur
système_d'exploitation
string
Système d'exploitation de l'utilisateur
city
string
Composante "ville" de la position géographique de l'utilisateur (basée sur l'adresse IP)
state
string
Composant d'état de la localisation de l'utilisateur (déterminé à partir de l'adresse IP)
country
string
Composant du pays de la localisation de l'utilisateur (déterminé à partir de l'adresse IP)
identifiants_type
string
Type d'identifiants utilisés pour la journalisation dans cette session
étendue_à
string
Heure de la dernière extension de cette session par l'utilisateur
nombre_étendu
integer
Nombre de fois où cette session a été prolongée
ID utilisateur
string
Utilisateur réel lorsque cette session représente un utilisateur sudo'ing as another as
créé le
string
Heure de début de cette session
expire le
string
Heure d'expiration de cette session
url
string
Lien pour obtenir cet élément
État de l'interface utilisateur
objet
Dictionnaire par utilisateur d'informations d'état non documentées appartenant à l'UI Looker.
employé_Looker_cherché
booléen
L'utilisateur est identifié comme employé de Looker qui a été validé via l'authentification d'entreprise Looker
rôles_gérés_en_externe
booléen
Les rôles utilisateur sont gérés par un annuaire externe comme SAML ou LDAP et ne peuvent pas être modifiés directement.
allow_direct_roles (rôles directs)
booléen
Un rôle peut être attribué directement à l'utilisateur.
autoriser_normal_group_membership
booléen
L'utilisateur peut être un membre direct d'un groupe Looker normal.
allow_roles_from_normal_groups (groupes de rôles autorisés)
booléen
L'utilisateur peut hériter des rôles d'un groupe Looker normal.
id_du_groupe_d'intégration
string
(Intégration uniquement) ID du dossier de groupe de l'utilisateur, basé sur l'ID externe du groupe (facultatif) spécifié lors de la connexion de l'utilisateur intégré
url
string
Lien pour obtenir cet élément

400 Bad Request

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

404: introuvable

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

Examples

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