更新时间:2025-09-12 GMT+08:00
分享

获取组织中组织列表

功能介绍

获取特定项目下组织的组织单元(OU)列表,支持分页。

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/multi-accounts/organizational-unit-list

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,用于标识特定的项目。

表2 Query参数

参数

是否必选

参数类型

描述

account_id

String

账号ID,用于过滤特定的账号。

limit

Integer

每页返回的记录数。

marker

String

返回记录的偏移量。

parent_id

String

父账号ID,用于过滤特定父账号下的子账号。

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

ou_list

Array of OrganizationOU objects

组织单位列表

page_info

PaginationResponse object

分页信息

表4 OrganizationOU

参数

参数类型

描述

id

String

组织单位ID

name

String

组织单位名称

ou_list

Array of OrganizationOU objects

子组织单位列表

表5 PaginationResponse

参数

参数类型

描述

marker

String

分页标记

total

Integer

总记录数

请求示例

响应示例

状态码

状态码

描述

200

请求成功,返回组织单元列表。

401

未授权,用户没有权限访问该资源。

403

禁止访问,用户权限不足。

404

未找到,请求的资源不存在。

错误码

请参见错误码

相关文档