Crée un groupe pour le locataire spécifié.

Habilitation requise : manageUserGroups (Gérer les utilisateurs et les groupes), ou manageAllUserGroups (Synchroniser les utilisateurs et les groupes), ou manageUserStandardGroups (Gérer les utilisateurs et les groupes standard), ou manageGroups (Gérer tous les groupes mais pas leurs membres), ou manageStandardGroups (Gérer les groupes standard mais pas leurs membres), ou manageGroupMembers (Gérer tous les groupes et leurs membres), ou manageStandardGroupMembers (Gérer les groupes standard et leurs membres).
Note : Vous n'avez besoin que d'un seul droit, mais vous pouvez en avoir plusieurs.

Pour créer un groupe, il faut un displayName. Un attribut Description facultatif peut être défini pour décrire le groupe. Un groupe peut être créé avec ou sans membres. Lorsqu'un groupe est créé avec des membres, une liste de membres doit être transmise.

Par défaut, un courriel est envoyé à chaque membre utilisateur régulier ajouté au groupe. Les membres utilisateurs fédérés ne reçoivent pas de notification par courriel. Le modèle d'e-mail pour le branding se trouve à "notifications/user_management/group/ {locale}/group_added_email.xml ". Passez le paramètre de requête themeId pour marquer le modèle d'e-mail pour les notifications. Pour désactiver les notifications par courrier électronique, envoyez l'option de notification " urn:ietf:params:scim:schemas:extension:ibm:2.0:Notification " : {"notifyType":"NONE"} dans le payload.

Limitations pour les locataires qui prennent en charge de grands groupes :

- Un maximum de 256 membres de groupe imbriqués de premier niveau est autorisé.
- Un maximum de 2 500 membres utilisateurs est autorisé dans le payload d'entrée. Pour ajouter des membres, utilisez PATCH.


Pour vérifier si le locataire prend en charge les grands groupes, exécutez l'API GET /v2.0/SCIM/capabilities.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

L'identifiant du thème que vous souhaitez appliquer.

Body Params

L'objet groupe qui contient les attributs du groupe à créer.

schemas
array of strings
required

Un tableau de chaînes contenant les URI indiquant les espaces de noms des schémas SCIM qui définissent les attributs dans la structure JSON actuelle. Les schémas " urn:ietf:params:scim:schemas:core:2.0:Group ", urn:ietf:params:scim:schemas:extension:ibm:2.0:Group " et " urn:ietf:params:scim:schemas:extension:ibm:2.0:Notification " sont valides. Le schéma de groupe principal est requis.

schemas*
string
required

Le nom d'affichage du groupe. La longueur maximale est de 255 caractères.

members
array of objects

Liste des membres en cours d'ajout. Lors de la création d'un groupe, le nombre d'éléments doit être inférieur ou égal à 10 000.

members
urn:ietf:params:scim:schemas:extension:ibm:2.0:Group
object
urn:ietf:params:scim:schemas:extension:ibm:2.0:Notification
object
string

Identifiant de la ressource du groupe tel que défini par le client de provisionnement. La longueur maximale est de 240 caractères.

boolean
Responses

Language
URL
LoadingLoading…
Response
Choose an example:
application/scim+json