获取组织中账号资产统计列表 - ListMemberAccountLists
功能介绍
功能介绍:获取组织中账号资产统计列表。is_dsc_member_account=true 时仅查询已加入 DSC 多账号管理的成员账号,并支持 account_id/account_name/offset/limit 过滤与分页;为 false(默认)时返回组织内全部账号,此时上述过滤与分页参数不生效,parent_id 与 marker 在本接口均不生效。
响应:请求成功返回HTTP 200及账号资产统计列表。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v1/{project_id}/multi-accounts/member-account-list
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID。可参考获取项目ID获取。 约束限制: 不涉及 取值范围: 以IAM服务接口返回值为准,长度为32个字符。 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| limit | 否 | Integer | 参数解释: 每页返回的最大结果数量,用于控制分页查询时单页返回的结果条数(仅 is_dsc_member_account=true 时生效) 约束限制: 不涉及 取值范围: 1~2000 默认取值: 1000 |
| marker | 否 | String | 参数解释: 分页标记,用于标识查询结果的分页位置(当前接口不生效,按 offset/limit 分页) 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| parent_id | 否 | String | 参数解释: 父节点唯一标识符(当前接口不生效,该参数仅在 OU 列表接口使用) 约束限制: 不涉及 取值范围: 字符串,最长100个字符 默认取值: 不涉及 |
| account_id | 否 | String | 参数解释: 账号ID,多账号管理中组织成员账号的唯一标识(仅 is_dsc_member_account=true 时生效) 约束限制: 不涉及 取值范围: 字符串,最长100个字符 默认取值: 不涉及 |
| account_name | 否 | String | 参数解释: 账号名称,用于按名称筛选组织中的账号(仅 is_dsc_member_account=true 时生效) 约束限制: 不涉及 取值范围: 字符串,最长100个字符 默认取值: 不涉及 |
| is_dsc_member_account | 否 | Boolean | 参数解释: 是否仅查询已加入DSC多账号管理的成员账号 约束限制: 不涉及 取值范围: true:仅查询成员账号,false:查询全部账号 默认取值: false |
| offset | 否 | Integer | 参数解释: 偏移量,用于指定分页查询的起始位置(仅 is_dsc_member_account=true 时生效) 约束限制: 不涉及 取值范围: 不涉及 默认取值: 0 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。通过调用IAM服务查询用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| page_info | Pagination object | 参数解释: 分页信息 取值范围: 不涉及 |
| ou_infos | Array of OrgOuInfoAssets objects | 参数解释: 组织单元(OU)信息列表 取值范围: 不涉及 |
| accounts | Array of AccountWithAssetsInfo objects | 参数解释: 组织中的账号列表 取值范围: 不涉及 |
| org_accounts | Map<String,AccountWithAssetsInfo> | 参数解释: 组织账号信息映射,键为账号ID 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total | Integer | 参数解释: 总记录数 取值范围: 不涉及 |
| marker | String | 参数解释: 分页标记,用于标识查询结果的分页位置 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| name | String | 参数解释: 组织单元名称 取值范围: 不涉及 |
| id | String | 参数解释: 组织单元ID 取值范围: 不涉及 |
| ou_infos | Array of OrgOuInfoAssets objects | 参数解释: 子级组织单元信息列表 取值范围: 不涉及 |
| accounts | Array of AccountWithAssetsInfo objects | 参数解释: 组织单元下的账号列表 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| name | String | 参数解释: 账号名称 取值范围: 不涉及 |
| project_id | String | 参数解释: 项目ID 取值范围: 不涉及 |
| domain_id | String | 参数解释: 账号的唯一标记 取值范围: 不涉及 |
| organization_id | String | 参数解释: 成员账号所属的组织ID 取值范围: 不涉及 |
| multi_account_project_id | String | 参数解释: 开通DSC多账号管理的项目ID 取值范围: 不涉及 |
| multi_account_domain_id | String | 参数解释: 开通DSC多账号管理的账号ID 取值范围: 不涉及 |
| member_tags | Array of DscMemberTagInfo objects | 参数解释: 成员账号的标签信息列表 取值范围: 不涉及 |
| is_dsc_member_account | Boolean | 参数解释: 是否为DSC多账号管理的成员账号 取值范围: true:是,false:否 |
| obs_count | Integer | 参数解释: OBS资产数量 取值范围: 不涉及 |
| db_count | Integer | 参数解释: 数据库资产数量 取值范围: 不涉及 |
| bigdata_count | Integer | 参数解释: 大数据资产数量 取值范围: 不涉及 |
请求示例
获取组织中账号资产统计列表
/v1/0c3039178b80d36e2fd0c009a6bd4f05/multi-accounts/member-account-list
响应示例
状态码:200
{
"page_info" : {
"total" : 1,
"marker" : null
},
"accounts" : [ {
"name" : "account-001",
"domain_id" : "1a2b3c4d5e6f708192a3b4c5d6e7f809",
"is_dsc_member_account" : true,
"obs_count" : 3,
"db_count" : 5,
"bigdata_count" : 1
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询成功 |
错误码
请参见错误码。