Method: customers.v2.Groups.list

Récupère une liste de groupes.

  • Les requêtes doivent spécifier un filtre. Les requêtes sans paramètre filter renvoient une erreur tooMany.
  • Le paramètre filter n'accepte que l'égalité sur displayName (par exemple, displayName eq "Group Name") ou externalId (par exemple, externalId eq "ddaafa46e2b6").
  • Les correspondances de sous-chaîne (co, sw, ew), les opérateurs logiques (and, or) et les filtres de valeurs complexes ne sont pas acceptés.
  • La pagination n'est pas acceptée. Si plus de 50 groupes correspondent, seuls les 50 premiers résultats seront renvoyés.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. Numéro client.

Paramètres de requête

Paramètres
filter

string

Paramètre de filtre.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour la liste des groupes.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "schemas": [
    string
  ],
  "resources": [
    {
      object (Group)
    }
  ],
  "totalResults": integer
}
Champs
schemas[]

string

Schémas des ressources renvoyées.

resources[]

object (Group)

Liste des ressources demandées.

totalResults

integer

Nombre total de résultats.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Pour en savoir plus, consultez le guide d'autorisation.