orchestrator
2022.10
false
- 基本情報
- Swagger の定義
- Orchestrator API
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。
![](https://docs.uipath.com/_next/static/media/grid.05ebd128.png?w=3840&%3Bq=100)
Orchestrator API ガイド
ユーザーの要求
注:
/odata/Users
または/odata/Users({})
エンドポイントに GET 要求を送信すると、Active Directory ユーザーでは空のドメインが返されます。GetOrganizationUnits(Id)
およびGetRoles(Id)
要求を送信しても、自動プロビジョニングされたユーザーに明示的に設定されたフォルダーおよびロールしか返されません。グループの設定を継承したフォルダーやロールを取得するには、/api/DirectoryService/GetDirectoryPermissions?userId={userId}
エンドポイントを使用してください。
PUT
https://{yourDomain}/odata/Users(13)
{
"RobotProvision": {
"UserName": "uipath\\john.smith",
"RobotId": 53,
"RobotType": "Development",
"ExecutionSettings": {}
}
}
{
"RobotProvision": {
"UserName": "uipath\\john.smith",
"RobotId": 53,
"RobotType": "Development",
"ExecutionSettings": {}
}
}
このエンドポイントを使用すると、指定したユーザー ID (グループ、ユーザー アカウント、またはロボット アカウントの ID) に 1 つ以上のロールを割り当てることができます。
POST
https://{yourDomain}/odata/Users(9)/UiPath.Server.Configuration.OData.AssignRoles
{
"roleIds": [
1,3
]
}
{
"roleIds": [
1,3
]
}
例
以下の要求では、ユーザー ID が
9
であるアカウントまたはグループを更新します。そのために、割り当てられているロールを、ID が 1
および 3
のロールで上書きします。
要求前のロール |
要求後のロール |
変更箇所 |
---|---|---|
ロールはありません。 |
3 および 1 |
ID が
1 および 3 のロールが割り当てられている
|
ID が
1 および 2 のロール |
3 および 1 |
ID
2 のロールが削除され、ID 3 のロールが割り当てられました。
|
ID が
2 のロール |
3 および 1 |
ID
2 を含むロールが削除され、ID 1 と 3 を含むロールが割り当てられました。
|
cURL
curl -X POST "https://{yourDomain}/odata/Users({key})/UiPath.Server.Configuration.OData.AssignRoles" -H "accept: application/json" -H "Content-Type: application/json"
-d "{ \"roleIds\": [ {RoleID1},{RoleID2} ] }"
Swagger UI (
https://https://{yourDomain}/swagger
で利用可能)
アカウントにロールを割り当てる手順の例を以下に示します。
-
/odata/Roles
に GET 要求を送信し、ロールのリストを取得します。必要に応じて、OData がサポートする任意の種類のフィルターを使用できます。
- 割り当てるロールの ID をメモします。
-
/odata/Users
に GET 要求を送信し、アカウントのリストを取得します。このリストには、グループ、ユーザー アカウント、ロボット アカウントが含まれます。
必要に応じて、OData がサポートする任意の種類のフィルターを使用できます。
- ロールを割り当てるアカウントの ID をメモします。
-
ロールを割り当てるアカウントごとに、
/odata/Users({key})/UiPath.Server.Configuration.OData.AssignRoles
に POST 要求を実行します。{key}
は、ロールを割り当てるアカウントの 1 つのアカウント ID です。{roleID}
は、割り当てるロールの 1 つのロール ID です。複数の ID を指定する場合は、各 ID をコンマで区切って記述できます。