[Aperçu] Supprimer des groupes

Supprime plusieurs groupes d'une organisation, en fonction de l'ID de l'organisation.

Point de terminaison de l’API

DELETE https://{yourDomain}/identity/api/Group/{partitionGlobalId}

Étendues

Nécessite les étendues suivantes :

• PM.Group
• PM.Group.Write

En-têtes de requête.

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

Remarque : pour obtenir le {access_token}, assurez-vous de vous authentifier via l'une des méthodes décrites ici.

Paramètres de chemin d'accès

Paramètre du chemin d'accès	Type de données	Description
partitionGlobalId (requis)	Chaîne de caractères (string)	L'ID de l'organisation pour laquelle vous souhaitez récupérer les groupes.

Corps de la requête

Le corps de la requête contient la liste des ID de groupes personnalisés que vous souhaitez supprimer en bloc de l'organisation.

{
     "groupIDs": [
          "string",
          "string"
     ]
}

Réponses

200 OK

Les groupes personnalisés indiqués sont supprimés de l'organisation.

Exemple de requête

Supposons que vous ayez rassemblé toutes les informations nécessaires pour créer l'appel d'API.

• Votre {baseURL} est : https://{yourDomain}/{organizationName}/{tenantName}/
• Votre {access_token} est : 1234 (pour des considérations de longueur).
• Le {partitionGlobalId} est : magic-7

• Les groupes personnalisés que vous souhaitez supprimer ont les ID suivants :

  • Groupe 1 : group1
  • Groupe 2 : group2

L’appel devrait ressembler à l'exemple ci-dessous (cURL) :

curl --location --request DELETE 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/Group/magic-7' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
     "groupIDs": [
          "group1",
          "group2"
     ]
}'