获取组织中账号资产统计列表 - ListOrganizationalUnitLists
功能介绍
功能介绍:获取组织中账号资产统计列表
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v1/{project_id}/multi-accounts/organizational-unit-list
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID。可参考获取项目ID获取。 约束限制: 不涉及 取值范围: 以IAM服务接口返回值为准,长度为32个字符。 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| limit | 否 | Integer | 参数解释: 每页返回的最大结果数量,用于控制分页查询时单页返回的结果条数 约束限制: 不涉及 取值范围: 1~2000 默认取值: 1000 |
| marker | 否 | String | 参数解释: 分页标记,用于标识查询结果的分页位置。通常从上一次查询的响应分页信息中获取,配合limit参数实现分页查询,获取下一页数据 约束限制: 不涉及 取值范围: 字符串,4~400个字符 默认取值: 不涉及 |
| parent_id | 否 | String | 参数解释: 父节点唯一标识符,用于指定查询的组织单元(OU)父节点,标识组织结构的层级关系。可通过查询组织OU列表或OU组织树接口获取 约束限制: 不涉及 取值范围: 字符串,最长100个字符 默认取值: 不涉及 |
| account_id | 否 | String | 参数解释: 账号ID,多账号管理中组织成员账号的唯一标识。可通过IAM服务查询账号列表或查询组织中的账号列表接口获取 约束限制: 不涉及 取值范围: 字符串,最长100个字符 默认取值: 不涉及 |
| account_name | 否 | String | 参数解释: 账号名称,用于按名称筛选组织中的账号 约束限制: 不涉及 取值范围: 字符串,最长100个字符 默认取值: 不涉及 |
| is_dsc_member_account | 否 | Boolean | 参数解释: 是否仅查询已加入DSC多账号管理的成员账号 约束限制: 不涉及 取值范围: true:仅查询成员账号,false:查询全部账号 默认取值: false |
| offset | 否 | Integer | 参数解释: 偏移量,用于指定分页查询的起始位置 约束限制: 不涉及 取值范围: 不涉及 默认取值: 0 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。通过调用IAM服务查询用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| page_info | Pagination object | 参数解释: 页信息 取值范围: 不涉及 |
| ou_list | Array of OrganizationOU objects | 参数解释: OU(组织单元)列表,每个元素为一个OrganizationOU对象,包含组织单元的ID、名称及子OU列表等信息 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total | Integer | 参数解释: 总记录数 取值范围: 不涉及 |
| marker | String | 参数解释: 分页标记,用于标识查询结果的分页位置 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 资源ID,唯一标识 取值范围: 不涉及 |
| name | String | 参数解释: 组织单元名称 取值范围: 不涉及 |
| ou_list | Array of OrganizationOU objects | 参数解释: OU树结构列表,每个元素为一个OrganizationOU对象,表示该组织单元下的子级组织单元,用于展示组织的层级结构 取值范围: 不涉及 |
请求示例
获取组织中账号资产统计列表
/v1/0c3039178b80d36e2fd0c009a6bd4f05/multi-accounts/organizational-unit-list
响应示例
状态码:200
{
"page_info" : {
"total" : 2,
"marker" : "ou-marker-0123abcd"
},
"ou_list" : [ {
"id" : "a1c3d4e5-7b2c-5048-c087-6b1e9c30fa51",
"name" : "ou-finance-01",
"ou_list" : [ ]
}, {
"id" : "c3d4e5f6-8c3d-6159-d198-7c2f0d41ab62",
"name" : "ou-security-01",
"ou_list" : [ ]
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询成功 |
错误码
请参见错误码。