[Vorschau] Gruppen löschen

Löscht mehrere Gruppen aus einer Organisation, basierend auf der Organisations-ID.

API-Endpunkt

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

Scopes

Folgende Scopes sind erforderlich:

PM.Group
PM.Group.Write

Anforderungsheader

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

Hinweis: Um das {access_token} zu erhalten, müssen Sie sich mit einer der hier beschriebenen Methoden authentifizieren.

Pfadparameter

Pfadparameter	Datentyp	Beschreibung
`partitionGlobalId` (erforderlich)	String	Die ID der Organisation, für die Sie die Gruppen abrufen möchten.

Anforderungstext

Der Anforderungstext enthält die Liste der benutzerdefinierten Gruppen-IDs, die Sie per Massenlöschung aus der Organisation löschen möchten.

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

Antworten

200 OK

Die angegebenen benutzerdefinierten Gruppen werden aus der Organisation gelöscht.

Beispielanforderung

Angenommen, Sie haben alle Informationen gesammelt, die zum Erstellen des API-Aufrufs erforderlich sind.

Ihre {baseURL} ist: https://{yourDomain}/{organizationName}/{tenantName}/
Ihre {access_token} ist: 1234 (aus Gründen der Länge).
Die {partitionGlobalId} lautet: magic-7
Die benutzerdefinierten Gruppen, die Sie löschen möchten, haben die folgenden IDs:
- Gruppe 1: group1
- Gruppe 2: group2

Der Aufruf sollte wie folgt aussehen (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"
     ]
}'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"
     ]
}'