调用ListOrganizationalUnits列表查询EIAM组织列表信息_应用身份服务 (IDaaS)(IDaaS)-阿里云帮助中心

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

调试

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

授权信息

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

请求语法

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

请求参数

名称	类型	必填	描述	示例值
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	long	数据总记录数。	1000
data	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：自建。 ding_talk：钉钉导入。 ad：AD 导入。 ldap：LDAP 导入。	build_in
organizationalUnitSourceId	string	组织来源 ID。自建类型默认为实例 ID，其他类型，分别对应不同来源的企业 ID，比如钉钉来源对应钉钉企业的 corpId。	idaas_ue2jvisn35ea5lmthk267xxxxx
createTime	long	组织创建时间，Unix 时间戳格式，单位为毫秒。	1652083425923
updateTime	long	组织最近更新时间，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": "测试组织"
    }
  ]
}

错误码

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

变更历史

变更时间

变更内容概要

操作

2023-10-24

API 内部配置变更，不影响调用

看变更集

变更项	变更内容
	API 内部配置变更，不影响调用。

错误码

HttpCode	Error Code	错误信息	说明
400	invalid_token	Access token is not valid	token 无效
400	OrganizationUnitIdNotInScopes	organizationUnitId : ou_wovwffm62xifdziem7an7xxxxx not in provisioning scope!	组织不在同步范围内
404	application_not_found	Application id not found: app_mkv7rgt4d7i4u7zqtzev2mxxxx	应用不存在
403	application_disabled	Application is disabled	应用处于禁用状态
403	application_api_disabled	Application api invoke disabled	应用 api 接口开放开关未开启
403	permission_denied	Require scopes: [urn:alibaba:idaas:scope:organizational_unit:read_all]	缺少 API 授权信息
500	Internal Server Error	Internal Server Error	服务器内部错误