- Erste Schritte
- Swagger-Definition
- Orchestrator-APIs
- Warnungsanforderungen
- Anfragen zu Assets
- Kalenderanforderungen
- Umgebungsabfragen
- Ordneranforderungen
- Generische Aufgabenanforderungen
- Jobanfragen
- Bibliotheksabfragen
- Lizenzabfragen
- Paketanfragen
- Berechtigungsabfragen
- Prozessabfragen
- Anforderungen von Warteschlangenelementen
- Roboteranfragen
- Rollenanfragen
- Zeitplanabfragen
- Anfragen zu Einstellungen
- Aufgabenanforderungen
- Aufgabenkataloganforderungen
- Aufgabenformularanforderungen
- Mandantenabfragen
- Transaktionsanfragen
- Benutzerabfragen
- Webhook-Abfragen
Anleitung für die Orchestrator-API
Benutzerabfragen
- GET-Anforderungen an die Endpunkte
/odata/Users
oder/odata/Users({})
geben eine leere Domäne für AD-Benutzer zurück. - Die Anforderungen
GetOrganizationUnits(Id)
undGetRoles(Id)
geben nur Ordner und Rollen zurück, die explizit für einen automatisch bereitgestellten Benutzer festgelegt wurden. Die von der Gruppenkonfiguration übernommen können über den Endpunkt/api/DirectoryService/GetDirectoryPermissions?userId={userId}
abgerufen werden.
Im folgenden Beispiel können Sie die Sprache für den Benutzer mit der 749-ID in Japanisch ändern.
Posten
{OrchestratorURL}/odata/Users(749)/UiPath.Server.Configuration.OData.ChangeUserCulture
PUT
{OrchestratorURL}/odata/Users(13)
{
"RobotProvision": {
"UserName": "uipath\\john.smith",
"RobotId": 53,
"RobotType": "Development",
"ExecutionSettings": {}
}
}
{
"RobotProvision": {
"UserName": "uipath\\john.smith",
"RobotId": 53,
"RobotType": "Development",
"ExecutionSettings": {}
}
}
Sie können diesen Endpunkt verwenden, um der angegebenen Benutzer-ID eine oder mehrere Rollen zuzuweisen. Dies kann die ID einer Gruppe, eines Benutzerkontos oder eines Roboterkontos sein.
Posten
{OrchestratorURL}/odata/Users(9)/UiPath.Server.Configuration.OData.AssignRoles
{
"roleIds": [
1,3
]
}
{
"roleIds": [
1,3
]
}
Beispiel
9
, indem die zugewiesenen Rollen mit den Rollen mit den IDs 1
und 3
überschrieben werden.
Rollen vor Anforderung |
Rollen nach Anforderung |
Änderungen |
---|---|---|
Keine Rollen |
1 und 3 |
Rollen mit den IDs
1 und 3 wurden zugewiesen.
|
Rollen mit den IDs
1 und 2 |
1 und 3 |
Rolle mit ID
2 wurde entfernt und Rolle mit ID 3 zugewiesen.
|
Rolle mit ID
2 |
1 und 3 |
Rolle mit der ID
2 wurde entfernt und Rollen mit den IDs 1 und 3 wurden zugewiesen.
|
cURL
curl -X POST "https://{server}/{OrgName}/{TenantName}/orchestrator_/odata/Users({key})/UiPath.Server.Configuration.OData.AssignRoles"
-H "accept: application/json" -H "Content-Type: application/json" -d "{ \"roleIds\": [ {RoleID1},{RoleID2} ] }"
https://<OrchestratorURL>/swagger
)
Hier ist ein Beispielverfahren zum Zuweisen von Rollen zu einem Konto:
-
Stellen Sie eine GET-Anforderung an
/odata/Roles
, um die Liste der Rollen abzurufen.Sie können bei Bedarf jeden Filtertyp verwenden, der von OData unterstützt wird.
- Notieren Sie sich die IDs für die Rollen, die Sie zuweisen möchten.
-
Stellen Sie eine GET-Anforderung an
/odata/Users
, um die Liste der Konten abzurufen.Die Liste enthält Gruppen, Benutzerkonten und Roboterkonten.
Sie können bei Bedarf jeden Filtertyp verwenden, der von OData unterstützt wird.
- Notieren Sie die IDs für die Konten, denen Sie Rollen zuweisen möchten.
-
Stellen Sie für jedes Konto, dem Sie Rollen zuweisen möchten, eine POST-Anforderung an
/odata/Users({key})/UiPath.Server.Configuration.OData.AssignRoles
.{key}
ist eine einzelne Konto-ID für das Konto, dem Sie Rollen zuweisen möchten{roleID}
ist eine einzelne Rollen-ID für die Rolle, die Sie zuweisen möchten; Sie können mehrere IDs auflisten, die durch ein Komma getrennt sind.