Method: customers.v2.Groups.list

Ruft eine Liste von Gruppen ab.

  • In Anfragen muss ein Filter angegeben werden. Anfragen ohne den Parameter filter geben einen tooMany-Fehler zurück.
  • Der Parameter filter unterstützt nur Gleichheit für displayName (z. B. displayName eq "Group Name") oder externalId (z. B. externalId eq "ddaafa46e2b6").
  • Teilstring-Übereinstimmungen (co, sw, ew), logische Operatoren (and, or) und komplexe Wertfilter werden nicht unterstützt.
  • Die Paginierung wird nicht unterstützt. Wenn es mehr als 50 Gruppenübereinstimmungen gibt, werden nur die ersten 50 Ergebnisse zurückgegeben.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Erforderlich. Die Kundennummer.

Suchparameter

Parameter
filter

string

Der Filterparameter.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für das Auflisten von Gruppen.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "schemas": [
    string
  ],
  "resources": [
    {
      object (Group)
    }
  ],
  "totalResults": integer
}
Felder
schemas[]

string

Die Schemas für die zurückgegebenen Ressourcen.
resources[]

object (Group)

Die Liste der angeforderten Ressourcen.
totalResults

integer

Die Gesamtzahl der Ergebnisse.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • 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

Weitere Informationen finden Sie im Autorisierungsleitfaden.