automation-suite
2024.10
false
- Erste Schritte
- Authentication
- Scopes und Berechtigungen
- Plattformverwaltungs-APIs
- Update User
- Bestimmten Benutzer löschen
- Benutzer löschen
Wichtig :
Bitte beachten Sie, dass dieser Inhalt teilweise mithilfe von maschineller Übersetzung lokalisiert wurde.
Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.
Automation Suite API-Handbuch
Löscht mehrere Benutzer aus einer Organisation, basierend auf den Benutzer-IDs.
API-Endpunkt
DELETE https://{yourDomain}/{organizationName}/identity_/api/User
Scopes
Folgende Scopes sind erforderlich:
PM.UserPM.User.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 unter Authentifizierungsmethoden beschriebenen Methoden authentifizieren.
Pfadparameter
| Pfadparameter | Datentyp | Beschreibung |
|---|---|---|
partitionGlobalId | String | Erforderlich. Die ID der Organisation, für die Sie die Roboterkonten abrufen möchten. |
Anforderungstext
Der Anforderungstext enthält die Liste der benutzerdefinierten Benutzer-IDs, die Sie per Massenlöschung aus der Organisation löschen möchten.
{
"partitionGlobalId": "string",
"userIds": [
"string"
]
}
{
"partitionGlobalId": "string",
"userIds": [
"string"
]
}
Antworten
204 Erfolg
Die angegebenen Roboterkonten 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 Benutzer, die Sie löschen möchten, haben die folgenden IDs:
- Dolores Umbridge:
dol-2908 - Quirinus Quirrell:
qui-2609
- Dolores Umbridge:
Der Aufruf sollte dem folgenden Beispiel ähneln (cURL):
curl --location --request DELETE 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/User' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
"partitionGlobalId": "magic-7",
"userIds": [
"dol-2908", "qui-2609"
]
}'
curl --location --request DELETE 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/User' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
"partitionGlobalId": "magic-7",
"userIds": [
"dol-2908", "qui-2609"
]
}'