分页查询EIAM的组织信息。
接口说明
当您需要获取根组织下的直接子组织时,请求参数应设置为:
{
"parentOrganizationalUnitId": "ou_root"
}
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
GET /v2/{instanceId}/{applicationId}/organizationalUnits HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Authorization |
string |
是 |
认证信息。 格式:Bearer ${access_token}。 示例:Bearer ATxxxx。 |
Bearer AT8csE2seYxxxxxij |
| instanceId |
string |
是 |
实例 ID。 |
idaas_ue2jvisn35ea5lmthk267xxxxx |
| applicationId |
string |
是 |
应用 ID。 |
app_mkv7rgt4d7i4u7zqtzev2mxxxx |
| parentId |
string |
是 |
父组织 ID。 |
ou_wovwffm62xifdziem7an7xxxxx |
| pageNumber |
integer |
否 |
页码,默认 1。 |
1 |
| pageSize |
integer |
否 |
单页大小读取记录数,默认 20,范围为 1~100。 |
20 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
响应结果。 |
||
| totalCount |
integer |
数据总记录数。 |
1000 |
| data |
array<object> |
返回数据对象列表。 |
|
|
object |
返回数据对象。 |
||
| instanceId |
string |
实例 ID。 |
idaas_ue2jvisn35ea5lmthk267xxxxx |
| organizationalUnitId |
string |
组织 ID。 |
ou_wovwffm62xifdziem7an7xxxxx |
| organizationalUnitName |
string |
组织名称。 |
name001 |
| parentId |
string |
父组织 ID。 |
ou_wovwffm62xifdziem7an7xxxxx |
| organizationalUnitExternalId |
string |
组织外部 ID,用于外部数据与 IDaaS 组织的数据关联映射,默认为 IDaaS 组织 ID。 说明:外部 ID 在同一来源类型和来源 ID 下唯一。 |
ou_wovwffm62xifdziem7an7xxxxx |
| organizationalUnitSourceType |
string |
组织来源类型,取值可选范围:
|
build_in |
| organizationalUnitSourceId |
string |
组织来源 ID。 自建类型默认为实例 ID,其他类型,分别对应不同来源的企业 ID,比如钉钉来源对应钉钉企业的 corpId。 |
idaas_ue2jvisn35ea5lmthk267xxxxx |
| createTime |
integer |
组织创建时间,Unix 时间戳格式,单位为毫秒。 |
1652083425923 |
| updateTime |
integer |
组织最近更新时间,Unix 时间戳格式,单位为毫秒。 |
1652083425923 |
| description |
string |
组织描述。 |
测试组织 |
示例
正常返回示例
JSON格式
{
"totalCount": 1000,
"data": [
{
"instanceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
"organizationalUnitId": "ou_wovwffm62xifdziem7an7xxxxx",
"organizationalUnitName": "name001",
"parentId": "ou_wovwffm62xifdziem7an7xxxxx",
"organizationalUnitExternalId": "ou_wovwffm62xifdziem7an7xxxxx",
"organizationalUnitSourceType": "build_in",
"organizationalUnitSourceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
"createTime": 1652083425923,
"updateTime": 1652083425923,
"description": "测试组织"
}
]
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。