Buscar usuarios

Versión 4.0.23.2

Buscar usuarios

Muestra todos* los registros del usuario que coinciden con los criterios de búsqueda especificados.

Si se proporcionan varios parámetros de búsqueda y el valor de filter_or es FALSO o no se especifica, se combinan los parámetros de búsqueda en una operación lógica AND. Solo se mostrarán las filas que coincidan con todos los criterios del parámetro de búsqueda.

Si filter_or es VERDADERO, se combinan varios parámetros de búsqueda en una operación lógica OR. Los resultados incluirán filas que coincidan con cualquiera de los criterios de búsqueda.

Los parámetros de búsqueda de strings usan coincidencias que no distinguen mayúsculas de minúsculas. Los parámetros de búsqueda de strings pueden contener % y "_" ya que el patrón de LIKE de SQL coincide con las expresiones de comodín. example="dan%" coincidirá con "danger" y "Danzig", pero no "David" example="D_m%" coincidirá con "Damage" y "volcado".

Los parámetros de búsqueda de números enteros pueden aceptar un solo valor o una lista de valores separados por comas. Los múltiples valores se combinarán en una operación lógica OR, los resultados coincidirán con al menos uno de los valores especificados.

La mayoría de los parámetros de búsqueda pueden aceptar "IS NULL" y "NOT NULL" como expresiones especiales para hacer coincidir o excluir (respectivamente) filas en las que la columna es nula.

Los parámetros de búsqueda booleanos solo aceptan "true" y "false" como valores.

(*) Los resultados siempre se filtran según el nivel de información que el emisor puede ver. Los administradores de Looker pueden ver todos los detalles del usuario. Los usuarios normales en un sistema abierto pueden ver los nombres de otros usuarios, pero no los detalles. Los usuarios normales de un sistema cerrado solo pueden ver los nombres de otros usuarios que son miembros del mismo grupo que el usuario.

Solicitud

GET /users/search
Tipo de datos
Descripción
Solicitud
HTTPRequest
verá la consulta cuando se guarde
HTTPQuery
Expandir definición de HTTPQuery...
campos
string
Incluye solo estos campos en la respuesta
página
integer
OBSOLETO. En su lugar, usa el límite y el desplazamiento. Mostrar solo la página N de resultados paginados
por página
integer
OBSOLETO. En su lugar, usa el límite y el desplazamiento. Muestra N filas de datos por página
límite
integer
Cantidad de resultados que se mostrarán. (se usa con desplazamiento y tiene prioridad sobre la página y por página)
offset
integer
Cantidad de resultados que se omiten antes de mostrar uno. (se usa con límite y tiene prioridad sobre la página y por página)
ordena
string
Campos para ordenar.
id
string
ID de usuario de coincidencia.
first_name
string
Nombre y nombre.
last_name
string
Apellido.
verificación_empleado_empleado
booleano
Buscar cuentas de usuario asociadas con empleados de Looker
usuario_incorporado
booleano
Buscar solo usuarios incorporados
correo electrónico
string
Buscar el usuario con esta dirección de correo electrónico
está_inhabilitado
booleano
Buscar cuentas de usuario inhabilitadas
filtro_o
booleano
Combinar determinados criterios de búsqueda en una expresión booleana OR
id_metadatos_contenido
string
Buscar usuarios que tengan acceso a este elemento content_metadata
group_id
string
Buscar usuarios que sean miembros directos de este grupo

Respuesta

200: Usuarios que coinciden.

Tipo de datos
Descripción
(array)
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
avatar_url
string
URL de la imagen de avatar (puede ser genérica)
avatar_url_sin_tamaño
string
URL de la imagen de avatar (puede ser genérica), no especifica el tamaño
credenciales_api3
Expandir la definición de CredentialsApi3...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
id
string
ID único
client_id
string
Clave de API client_id
creado_en
string
Marca de tiempo para la creación de esta credencial
está_inhabilitado
booleano
¿Se inhabilitó esta credencial?
tipo
string
Nombre corto del tipo de este tipo de credencial
url
string
Vínculo para obtener este elemento
credenciales_correoelectrónico
Credenciales de acceso con correo electrónico y contraseña
Expandir la definición del correo electrónico de las credenciales...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
creado_en
string
Marca de tiempo para la creación de esta credencial
correo electrónico
string
Dirección de correo electrónico utilizada para el acceso del usuario
forzar_contraseña_restablecer_acceso_siguiente
booleano
Forzar al usuario a cambiar su contraseña la próxima vez que acceda
user_id
string
ID único del usuario
está_inhabilitado
booleano
¿Se inhabilitó esta credencial?
se accedió
string
Marca de tiempo del acceso más reciente con credencial
URL_restablecimiento_de_contraseña
string
URL con un token secreto de uso único que el usuario puede usar para restablecer la contraseña
URL_configuración_cuenta
string
URL con un token secreto de uso único que el usuario puede utilizar para configurar la cuenta
tipo
string
Nombre corto del tipo de este tipo de credencial
url
string
Vínculo para obtener este elemento
URL_usuario
string
Vínculo para obtener este usuario
Incorporación de credenciales
Expandir la definición de CredentialsEmbed...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
creado_en
string
Marca de tiempo para la creación de esta credencial
id_grupo_externo
string
ID de la herramienta de incorporación para un grupo al que se agregó este usuario durante el acceso más reciente
id_usuario_externo
string
ID único del insertador para el usuario
id
string
ID único
está_inhabilitado
booleano
¿Se inhabilitó esta credencial?
se accedió
string
Marca de tiempo del acceso más reciente con credencial
tipo
string
Nombre corto del tipo de este tipo de credencial
url
string
Vínculo para obtener este elemento
credenciales_google
Credenciales de autenticación de Google
Expandir la definición de CredentialsGoogle...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
creado_en
string
Marca de tiempo para la creación de esta credencial
dominio
string
Dominio de Google
correo electrónico
string
Dirección de correo electrónico
id_usuario_google
string
ID único de Google para este usuario
está_inhabilitado
booleano
¿Se inhabilitó esta credencial?
se accedió
string
Marca de tiempo del acceso más reciente con credencial
tipo
string
Nombre corto del tipo de este tipo de credencial
url
string
Vínculo para obtener este elemento
credenciales_ldap
Credenciales LDAP
Expandir definición de CredentialsLDAP...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
creado_en
string
Marca de tiempo para la creación de esta credencial
correo electrónico
string
Dirección de correo electrónico
está_inhabilitado
booleano
¿Se inhabilitó esta credencial?
LDAP_LDN
string
Nombre distinguido de LDAP para este usuario (a partir del último acceso)
ID de LDAP
string
ID único de LDAP para este usuario
se accedió
string
Marca de tiempo del acceso más reciente con credencial
tipo
string
Nombre corto del tipo de este tipo de credencial
url
string
Vínculo para obtener este elemento
credenciales_looker_openid
Credenciales de LookerOpenID. Lo usan los analistas de Looker para acceder
Expandir la definición de CredentialsLookerOpenid...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
creado_en
string
Marca de tiempo para la creación de esta credencial
correo electrónico
string
Dirección de correo electrónico utilizada para el acceso del usuario
está_inhabilitado
booleano
¿Se inhabilitó esta credencial?
se accedió
string
Marca de tiempo del acceso más reciente con credencial
se accedió
string
Dirección IP del cliente para el acceso más reciente con credencial
tipo
string
Nombre corto del tipo de este tipo de credencial
url
string
Vínculo para obtener este elemento
URL_usuario
string
Vínculo para obtener este usuario
credenciales_oidc
Credenciales de autenticación de OpenID Connect
Expandir la definición de CredentialsOIDC...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
creado_en
string
Marca de tiempo para la creación de esta credencial
correo electrónico
string
Dirección de correo electrónico
está_inhabilitado
booleano
¿Se inhabilitó esta credencial?
se accedió
string
Marca de tiempo del acceso más reciente con credencial
id_usuario_id
string
ID único de la OP de OIDC para este usuario
tipo
string
Nombre corto del tipo de este tipo de credencial
url
string
Vínculo para obtener este elemento
credenciales_saml
Credenciales de autenticación Saml
Expandir la definición de CredentialsSaml...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
creado_en
string
Marca de tiempo para la creación de esta credencial
correo electrónico
string
Dirección de correo electrónico
está_inhabilitado
booleano
¿Se inhabilitó esta credencial?
se accedió
string
Marca de tiempo del acceso más reciente con credencial
ID del usuario de saml
string
ID único del IdP de Saml para este usuario
tipo
string
Nombre corto del tipo de este tipo de credencial
url
string
Vínculo para obtener este elemento
credenciales_totp
Credenciales de dos factores
Expandir la definición de CredentialsTotp...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
creado_en
string
Marca de tiempo para la creación de esta credencial
está_inhabilitado
booleano
¿Se inhabilitó esta credencial?
tipo
string
Nombre corto del tipo de este tipo de credencial
verificado
booleano
Usuario verificado
url
string
Vínculo para obtener este elemento
display_name
string
Nombre completo para mostrar (disponible solo si se configuran el nombre y el apellido)
correo electrónico
string
Dirección de correo electrónico
id_espacio_grupo_incorporación
string
(OBSOLETO) (solo incorporado) ID del espacio de grupo del usuario en función del external_group_id especificado de forma opcional durante el acceso de usuario del usuario.
first_name
string
Nombre
id de grupo
string[]
ID_de_la_carpeta_principal
string
String de ID para la carpeta principal del usuario
id
string
ID único
está_inhabilitado
booleano
Se inhabilitó la cuenta
last_name
string
Apellido
Configuración regional
string
Configuración regional preferida del usuario La configuración regional del usuario tiene prioridad sobre la configuración regional predeterminada de todo el sistema de Looker. La configuración regional determina el idioma de las strings de visualización y el formato numérico y de fecha en las respuestas de la API. La string de configuración regional debe ser un código de idioma de 2 letras o una combinación de código de idioma y región: "en" o "en-US", por ejemplo.
versiones_búsqueda
string[]
modelos_dir_validados
booleano
Se verificó el lugar de trabajo de desarrollo del usuario en busca de proyectos de producción aplicables
ID_carpeta_personal
string
ID de la carpeta personal del usuario
empleado_presunto_mirador
booleano
Se identifica al usuario como empleado de Looker
ID de función
string[]
sessions
Expandir definición de sesión...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
id
string
ID único
ip_address
string
Dirección IP del usuario cuando se inició esta sesión
browser
string
Tipo de navegador del usuario
operating_system
string
Sistema operativo del usuario
city
string
Componente de ciudad de la ubicación del usuario (derivado de la dirección IP)
state
string
Componente de estado de la ubicación del usuario (derivado de la dirección IP)
country
string
Componente de país de la ubicación del usuario (derivado de la dirección IP)
tipo_de_credenciales
string
Tipo de credenciales que se usa para acceder en esta sesión
extendido_en
string
Hora a la que el usuario extendió esta sesión por última vez
recuento_extendido
integer
Cantidad de veces que se amplió esta sesión
sudo_user_id
string
Usuario real en el caso en el que esta sesión representa a un usuario que realiza el trabajo como otro
creado_en
string
Hora a la que se inició esta sesión
vence_a las
string
Hora a la que vencerá esta sesión
url
string
Vínculo para obtener este elemento
IU_Estado
objeto
Según el diccionario del usuario, información de estado no documentada que pertenece a la IU de Looker.
verificación_empleado_empleado
booleano
Se identifica al usuario como empleado de Looker verificado en la autenticación corporativa de Looker
roles_externally_administrado
booleano
Los roles de los usuarios se administran mediante un directorio externo, como SAML o LDAP, y no se pueden cambiar directamente.
roles_directos
booleano
Al usuario se le puede asignar un rol de forma directa.
permitir_grupo_normal_membresía
booleano
El usuario puede ser miembro directo de un grupo normal de Looker.
allow_roles_from_normal_groups
booleano
El usuario puede heredar roles de un grupo normal de Looker.
id_carpeta_grupo_incorporación
string
ID (solo incorporado) de la carpeta de grupo del usuario en función del external_group_id especificado opcionalmente durante el acceso de usuario de incorporación
url
string
Vínculo para obtener este elemento

400: Bad Request

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

404: No encontrado

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

Ejemplos

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