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 las coincidencias de subcadenas (co, sw, ew), los operadores lógicos (and, or) ni los 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/v1beta1/customers/{customerId}/v2/Groups

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

Parámetros de ruta

Parámetros
customerId

string

Obligatorio. Es el ID de cliente.

Parámetros de consulta

Parámetros
filter

string

Es el parámetro de filtro.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el 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

Son los esquemas de los recursos devueltos.
resources[]

object (Group)

Es la lista de recursos solicitados.
totalResults

integer

Es 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.