Method: customers.v2.Groups.list

Recupera una lista de grupos.

  • Las solicitudes deben especificar un filtro. Las solicitudes sin un parámetro filter muestran un error tooMany.
  • El parámetro filter solo admite la igualdad en displayName (por ejemplo, displayName eq "Group Name") o externalId (por ejemplo, externalId eq "ddaafa46e2b6").
  • No se admiten coincidencias de subcadenas (co, sw, ew), operadores lógicos (and, or) ni filtros de valores complejos.
  • No se admite la paginación. Si hay más de 50 coincidencias de grupos, solo se mostrarán los primeros 50 resultados.

Solicitud HTTP

GET https://cloudidentityscim.googleapis.com/v1/customers/{customerId}/v2/Groups

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
customerId

string

Obligatorio. El ID del cliente.

Parámetros de consulta

Parámetros
filter

string

El parámetro de filtro.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Mensaje de respuesta de la lista de grupos.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "schemas": [
    string
  ],
  "resources": [
    {
      object (Group)
    }
  ],
  "totalResults": integer
}
Campos
schemas[]

string

Los esquemas de los recursos que se muestran.
resources[]

object (Group)

La lista de recursos solicitados.
totalResults

integer

La cantidad total de resultados.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/cloud-identity.groups.readonly
  • https://www.googleapis.com/auth/cloud-identity.groups
  • https://www.googleapis.com/auth/cloud-identity
  • https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta la guía de autorización.