按名称解析目录实体

根据组织 ID，按名称和类型解析单个目录实体。

API 端点

POST {accessURL}/{organizationName}/identity_/api/Directory/ResolveByName/{partitionGlobalId}

将所有端点路径中的{accessURL}替换为您的云平台的基本 URL：

Cloud Platform	访问 URL
Test Cloud	https://cloud.uipath.com/
Test Cloud 公共部门版	https://govcloud.uipath.us/
Test Cloud 专用版	https://{customURL}.dedicated.uipath.com/

作用域

需要以下作用域：

• PM.目录

请求标头

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

备注：

要获取{access_token} ，请确保通过此处描述的其中一种方法进行身份验证。

路径参数

路径参数	数据类型	描述
partitionGlobalId (必填)	字符串 (GUID)	要解析其中实体的组织 ID。

请求正文

请求正文指定要按名称解析的实体。

{
    "entityName": "string",
    "entityType": "User"
}

属性	数据类型	描述
entityName (必填)	字符串	目录实体的名称（例如，用户的电子邮件地址，组的组名称）。
entityType (必填)	字符串	目录实体的类型。有效值： User 、 Group和Application 。

响应

200 OK

返回完整目录实体。响应形状与“解决”端点相同（因实体类型而异）。

404 未找到

找不到实体或分区时返回。

请求示例

假设您收集了构建 API 调用所需的所有信息。

• 您的{baseURL}为: https://cloud.uipath.com/{organizationName}/identity
• 您的 {access_token} 为：1234（出于长度考虑）。
• {partitionGlobalId} 为：3fa85f64-5717-4562-b3fc-2c963f66afa6
• 您想通过电子邮件解析用户[e-mail] 。

调用应类似于以下示例 (cURL)：

curl --location --request POST 'https://cloud.uipath.com/{organizationName}/identity_/api/Directory/ResolveByName/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json' \
--data-raw '{
    "entityName": "[e-mail]",
    "entityType": "User"
}'

以下是成功调用的响应正文：

{
    "objectType": "DirectoryUser",
    "source": "aad",
    "identifier": "aad|a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "[e-mail]",
    "email": "[e-mail]",
    "displayName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "jobTitle": "Software Engineer",
    "companyName": "Contoso",
    "city": "Seattle",
    "department": "Engineering",
    "isActive": true,
    "creationTime": "2025-01-15T10:30:00Z"
}