导出用户角色分配

导出与任何 UiPath™ 产品关联的所有角色和角色分配的报告。

API 端点

GET https://cloud.uipath.com/<yourorgname>/pap_/api/userroleassignments/export

作用域

需要以下作用域：

• PM.User

• PM.User.Read

请求标头

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

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

查询参数

查询参数	数据类型	描述
exportoutputtype (必填)	字符串	指定两种可用的文件格式之一： .json或.csv

响应

200 OK

用户角色和角色分配报告将以.json或.csv格式下载到您的计算机。

请求示例

curl --location -- request GET 'https://cloud.uipath.com/acmeorg/pap_/api/userroleassignments/export?exportoutputtype=json' \
--header 'Authorization: Bearer {your token}

以下响应正文表示用户角色和角色分配检索已成功：

[
    {
        "Id": "34ecc3f3-a582-4cad-9889-120d7a3ffd62",
        "RoleUniqueName": "DOCUMENTUNDERSTANDING.DU VIEWER",
        "RoleDescription": "Can view all the entities but has not rights to edit or delete them.",
        "SecurityPrincipalId": "cdc34b5b-77d2-4ae1-9744-209d21ce557d",
        "RoleAssignmentType": "BuiltIn",
        "RoleType": "BUILTIN",
        "Scope": "/",
        "OrganizationId": "feb0dd79-85b6-483b-b297-0e49a1aa5b7d",
        "TenantId": null,
        "CreatedBy": "7f36fcc2-b822-430b-ae30-5ecfbacac186",
        "CreatedOn": "2023-03-30T08:30:04.9346766+00:00"
    },
...
]

下表描述了已导出文件中的标头字段：

字段	描述
ID	已分配角色的唯一标识符。
原始角色名称	界面中显示的角色名称。
角色说明	界面中显示的角色说明。
角色分配类型	创建时的角色分配类型，可以是以下两个选项之一： - 自定义，由用户进行的分配。 - 内置，由系统进行的分配。
角色类型	角色类型，由用户或系统定义： - 自定义（用户定义的角色） - 内置（系统定义的角色）
范围	作用域是组织层次结构中的特定级别，用作某些操作、权限和对象的边界。作用域可以是以下层次结构选项之一： - 组织 - 租户 - 服务 - 文件夹
安全主体 ID	用于标识用户、组等身份的唯一标识符。
安全主体类型	用户、组或机器人的身份类型。
安全主体电子邮件	用户的电子邮件地址。如果身份不是用户，则此字段为空。
安全主体显示名称	身份的名称。如果是目录用户，则此字段为空。
继承自组名称	继承角色分配的组名称。
继承自组 ID	继承角色分配的组标识符。
租户名称	进行分配的租户的名称。如果是组织级别的分配，则此字段为空。
组织名称	进行分配的组织的名称。
组织 ID	进行分配的组织的标识符。
租户 ID	进行分配的租户的标识符。如果是组织级别的分配，则此字段为空。
CreatedBy	创建分配的用户的唯一标识符。
创建日期	分配角色时的时间戳。