获取组织中组织列表 - ListOrganizationOUList
功能介绍
获取特定项目下组织的组织单元(OU)列表,支持分页。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v1/{project_id}/multi-accounts/organizational-unit-list
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID,用于标识特定的项目。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| account_id | 否 | String | 账号ID,用于过滤特定的账号。 |
| limit | 否 | Integer | 每页返回的记录数。 |
| marker | 否 | String | 返回记录的偏移量。 |
| parent_id | 否 | String | 父账号ID,用于过滤特定父账号下的子账号。 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| ou_list | Array of OrganizationOU objects | 组织单位列表 |
| page_info | PaginationResponse object | 分页信息 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 组织单位ID |
| name | String | 组织单位名称 |
| ou_list | Array of OrganizationOU objects | 子组织单位列表 |
请求示例
无
响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求成功,返回组织单元列表。 |
| 401 | 未授权,用户没有权限访问该资源。 |
| 403 | 禁止访问,用户权限不足。 |
| 404 | 未找到,请求的资源不存在。 |
错误码
请参见错误码。