Met à jour les attributs du groupe pour un locataire donné.

Intitulé requis : 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).
Remarque : Vous n'avez besoin que d'un seul droit, mais vous pouvez en avoir plusieurs.

En cas de succès, la réponse de retour contient les membres et les détails du groupe. La méthode HTTP PUT est utilisée pour remplacer les attributs de la ressource. Par exemple, les clients qui ont précédemment récupéré l'intégralité de la ressource et l'ont révisée, peuvent remplacer la ressource en utilisant un HTTP PUT.

Par défaut, un courrier électronique est envoyé à chaque membre utilisateur régulier ajouté et supprimé du groupe. Les membres utilisateurs fédérés ne reçoivent pas de notification par courriel. Les modèles de courrier électronique pour la stratégie de marque se trouvent à "notifications/user_management/group/ {locale}/user_added_to_group_email.xml " et "notifications/user_management/group/ {locale}/user_removed_from_group_email.xml ". Passez le paramètre de requête themeId pour marquer les modèles d'email 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 ne supportent pas les grands groupes :
- Un groupe de plus de 10.000 membres ne peut pas être modifié. Utilisez PATCH à la place.

Limitations pour les locataires qui prennent en charge des groupes importants :

- Un groupe de plus de 2 500 membres ne peut pas être modifié. Utilisez plutôt PATCH.
- La "taille" des modifications apportées à un groupe ne peut excéder 2 500 modifications de membres.
- Un maximum de 256 membres de groupe imbriqués de premier niveau est autorisé.

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…
Path Params
string
required

L'identifiant unique du groupe à modifier. Cet identifiant est transmis dans le chemin d'accès au site URL.

Query Params
string

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

Body Params

L'objet groupe qui contient les attributs du groupe à modifier.

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