{"Los alcances definen los permisos y los niveles de acceso para las solicitudes a la API y los tokens de autenticación."}
field:order, donde
order es 1 para orden ascendente y -1 para
orden descendente. Por ejemplo, created_at:1
in: query
name: sort
schema:
type: string
- description: >-
Filtro de conexión. Solo se aplica cuando se usa
search_engine=v1. Para filtrar por conexión con
search_engine=v2|v3, use
q=identities.connection:"connection_name"
in: query
name: connection
schema:
type: string
- description: >-
Lista de campos separados por comas que se incluirán o excluirán
(según el valor proporcionado para include_fields) en el resultado.
Déjelo vacío para recuperar todos los campos.
in: query
name: fields
schema:
type: string
- description: >-
Indica si los campos especificados se incluirán (true) o excluirán
(false).
in: query
name: include_fields
schema:
type: boolean
- description: >-
Consulta en sintaxis
de cadena de consulta de Lucene. Algunos tipos de consulta no
pueden usarse en campos de metadata; para obtener más información,
consulte Campos
consultables.
in: query
name: q
schema:
type: string
- description: La versión del motor de búsqueda
in: query
name: search_engine
schema:
$ref: '#/components/schemas/SearchEngineVersionsEnum'
- description: >-
Si es true (valor predeterminado), los resultados se devuelven en un
orden determinista. Si es false, los resultados pueden devolverse en
un orden no determinista, lo que puede mejorar el rendimiento de
consultas complejas dirigidas a un número reducido de usuarios.
Establézcalo en false solo cuando no se requieran un orden coherente
ni paginación.
in: query
name: primary_order
schema:
type: boolean
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ListUsersResponseContent'
description: Usuarios recuperados correctamente.
'400':
description: >-
Cadena de consulta de la solicitud no válida. El mensaje variará en
función de la causa.
x-description-1: >-
The 'q' parameter is available only if you specify
'search_engine=v2|v3'.
x-description-2: You are not allowed to use search_engine=v1.
x-description-3: >-
You are not allowed to use search_engine=v2. Use search_engine=v3
instead.
x-description-4: You are not allowed to use search_engine=v3.
x-description-5: >-
You can only page through the first 1000 records. See
https://auth0.com/docs/users/search/v3/view-search-results-by-page#limitation.
'401':
description: El cliente no es global.
x-description-1: Invalid signature received for JSON Web Token validation.
x-description-2: Invalid token.
'403':
description: >-
Scope insuficiente; se esperaba alguno de los siguientes:
read:users.
'429':
description: >-
Demasiadas solicitudes. Revise los encabezados X-RateLimit-Limit,
X-RateLimit-Remaining y X-RateLimit-Reset.
'503':
description: >-
La consulta superó el timeout. Intente refinar los criterios de
búsqueda. Consulte
https://auth0.com/docs/best-practices/search-best-practices.
security:
- bearerAuth: []
- oAuth2ClientCredentials:
- read:users
- read:user_idp_tokens
x-codeSamples:
- label: List or Search Users
lang: go
source: |
package example
import (
context "context"
management "github.com/auth0/go-auth0/management/management"
client "github.com/auth0/go-auth0/management/management/client"
option "github.com/auth0/go-auth0/management/management/option"
)
func do() {
client := client.NewClient(
option.WithToken(
"