ListOrganizationalUnits - 列表查询EIAM组织列表信息

调用ListOrganizationalUnits接口,分页查询EIAM组织信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

GET /v2/{instanceId}/{applicationId}/organizationalUnits

请求参数

名称类型必填描述示例值
Authorizationstring

认证信息。 格式:Bearer ${access_token}。 示例:Bearer ATxxxx。

Bearer AT8csE2seYxxxxxij
instanceIdstring

实例 ID。

idaas_ue2jvisn35ea5lmthk267xxxxx
applicationIdstring

应用 ID。

app_mkv7rgt4d7i4u7zqtzev2mxxxx
parentIdstring

父组织 ID。

ou_wovwffm62xifdziem7an7xxxxx
pageNumberinteger

页码,默认 1。

1
pageSizeinteger

单页大小读取记录数,默认 20,范围为 1~100。

20

返回参数

名称类型描述示例值
object

响应结果。

totalCountlong

数据总记录数。

1000
dataarray<object>

返回数据对象列表。

object

返回数据对象。

instanceIdstring

实例 ID。

idaas_ue2jvisn35ea5lmthk267xxxxx
organizationalUnitIdstring

组织 ID。

ou_wovwffm62xifdziem7an7xxxxx
organizationalUnitNamestring

组织名称。

name001
parentIdstring

父组织 ID。

ou_wovwffm62xifdziem7an7xxxxx
organizationalUnitExternalIdstring

组织外部 ID,用于外部数据与 IDaaS 组织的数据关联映射,默认为 IDaaS 组织 ID。

说明:外部 ID 在同一来源类型和来源 ID 下唯一。

ou_wovwffm62xifdziem7an7xxxxx
organizationalUnitSourceTypestring

组织来源类型,取值可选范围:

  • build_in:自建。
  • ding_talk:钉钉导入。
  • ad:AD 导入。
  • ldap:LDAP 导入。
build_in
organizationalUnitSourceIdstring

组织来源 ID。

自建类型默认为实例 ID,其他类型,分别对应不同来源的企业 ID,比如钉钉来源对应钉钉企业的 corpId。

idaas_ue2jvisn35ea5lmthk267xxxxx
createTimelong

组织创建时间,Unix 时间戳格式,单位为毫秒。

1652083425923
updateTimelong

组织最近更新时间,Unix 时间戳格式,单位为毫秒。

1652083425923
descriptionstring

组织描述。

测试组织

示例

正常返回示例

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": "测试组织"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-10-24API 内部配置变更,不影响调用查看变更详情

错误码

HttpCodeError Code错误信息说明
400invalid_tokenAccess token is not validtoken 无效
400OrganizationUnitIdNotInScopesorganizationUnitId : ou_wovwffm62xifdziem7an7xxxxx not in provisioning scope!组织不在同步范围内
404application_not_foundApplication id not found: app_mkv7rgt4d7i4u7zqtzev2mxxxx应用不存在
403application_disabledApplication is disabled应用处于禁用状态
403application_api_disabledApplication api invoke disabled应用 API 未开放
403permission_deniedRequire scopes: [urn:alibaba:idaas:scope:organizational_unit:read_all]缺少 API 授权信息
500Internal Server ErrorInternal Server Error服务器内部错误