全部產品
Search
文件中心

Identity as a Service:ListOrganizationalUnits - 列表查詢EIAM組織列表資訊

更新時間:Oct 10, 2025

分頁查詢EIAM的組織資訊。

介面說明

當您需要擷取根組織下的直接子組織時,請求參數應設定為:

{
  "parentOrganizationalUnitId": "ou_root"
}

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

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:自建。

  • ding_talk:DingTalk匯入。

  • ad:AD 匯入。

  • ldap:LDAP 匯入。

build_in

organizationalUnitSourceId

string

組織來源 ID。

自建類型預設為執行個體 ID,其他類型,分別對應不同來源的企業 ID,比如DingTalk來源對應DingTalk企業的 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": "測試組織"
    }
  ]
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情