automation-suite
2023.10
true
- Erste Schritte
- Authentication
- Scopes und Berechtigungen
- Plattformverwaltungs-APIs
[Vorschau] Neues Roboterkonto erstellen
Automation Suite API-Handbuch
Last updated 20. Aug. 2024
[Vorschau] Neues Roboterkonto erstellen
Erstellt ein neues Roboterkonto in der angegebenen Organisations-ID und weist es den angegebenen Gruppen zu.
--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.
Der Anforderungstext enthält die Organisations-ID, zu der die Gruppe hinzugefügt werden soll, und optional die Benutzer, die Sie als Mitglieder in der neuen Gruppe hinzufügen möchten.
{
"partitionGlobalId": "string",
"id": "string",
"name": "string",
"groupIDsToAdd": [
"string", "string"
]
}
{
"partitionGlobalId": "string",
"id": "string",
"name": "string",
"groupIDsToAdd": [
"string", "string"
]
}
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
- Sie möchten der Gruppe einen Namen geben:
"Gryffindors"
-
Sie möchten die Benutzer Ron, Harry und Hermine zur Gruppe hinzufügen. Diese Benutzer haben die folgenden Benutzer-IDs:
- Ron-Benutzer-ID:
ron-0103
- Harry-Benutzer-ID:
har-3107
- Hermine-Benutzer-ID:
her-1909
- Ron-Benutzer-ID:
Der Aufruf sollte wie folgt aussehen (cURL):
curl --location --request POST 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/Group' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
"name": "Roby",
"displayName": "Roby",
"partitionGlobalId": "magic-7",
"groupIDsToAdd": [
"gryff-01"
],
"groupIDsToRemove": []
}'
curl --location --request POST 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/Group' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
"name": "Roby",
"displayName": "Roby",
"partitionGlobalId": "magic-7",
"groupIDsToAdd": [
"gryff-01"
],
"groupIDsToRemove": []
}'
Hier ist die Antwort für einen erfolgreichen Aufruf:
{
"id": "rb-12",
"name": "Roby",
"displayName": "Roby",
"creationTime": "2021-10-20T15:20:29.1302044Z",
"lastLoginTime": null,
"groupIds": ["gryff-01"]
}
{
"id": "rb-12",
"name": "Roby",
"displayName": "Roby",
"creationTime": "2021-10-20T15:20:29.1302044Z",
"lastLoginTime": null,
"groupIds": ["gryff-01"]
}