[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'

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"
     ]
}

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"
     ]
}'