文档首页/资源治理中心 RGC/API参考/API/组织管理/列举控制策略生效的纳管账号信息 - ListManagedAccounts
更新时间：2026-02-27 GMT+08:00
查看PDF
分享

列举控制策略生效的纳管账号信息 - ListManagedAccounts

功能介绍

列举控制策略生效的纳管账号信息。

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

rgc:managedAccount:list

List

-

-

-

-

URI

GET /v1/managed-organization/managed-accounts

表1 Query参数

参数

是否必选

参数类型

描述

control_id

否

String

控制策略ID。

limit

否

Integer

分页页面的最大值。

marker

否

String

页面标记。

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

managed_accounts

Array of ManagedAccount objects

纳管的账号信息。

page_info

PageInfoDto object

本页返回条目数量。

表3 ManagedAccount

参数

参数类型

描述

landing_zone_version

String

纳管账号的Landing Zone版本。

manage_account_id

String

管理员账号ID。

account_id

String

纳管账号ID。

account_name

String

纳管账号名称。

account_type

String

纳管账号类型。LOGGING:日志记录账号;SECURITY:安全账号;PRIMARY:管理账号。

owner

String

纳管账号的创建来源，包括CUSTOM和RGC。

state

String

纳管账号状态。

message

String

错误状态描述信息。

parent_organizational_unit_id

String

父注册OU ID。

parent_organizational_unit_name

String

父注册OU名称。

identity_store_user_name

String

Identity Center用户名。

blueprint_product_id

String

模板ID。

blueprint_product_version

String

模板版本。

blueprint_status

String

模板部署状态，包括失败, 完成, 进行中。

is_blueprint_has_multi_account_resource

Boolean

模板是否包含多账号资源。

regions

Array of RegionManagedList objects

区域信息。

created_at

String

纳管账号的创建时间。

updated_at

String

纳管账号的更新时间。

表4 RegionManagedList

参数

参数类型

描述

region

String

区域名字。

region_status

String

区域的状态，取值为可用或者不可用。

表5 PageInfoDto

参数

参数类型

描述

next_marker

String

在标签请求参数中使用以获取输出的下一部分。重复此操作，直到响应元素返回null。如果存在，则表示可用的输出比当前响应中包含的输出多。

current_count

Integer

本页返回条目数量。

状态码：403

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

request_id

String

请求唯一标识

encoded_authorization_message

String

加密的错误信息

details

Array of ForbiddenErrorDetail objects

跨服务调用无权限错误信息

表7 ForbiddenErrorDetail

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误信息

请求示例

列举控制策略生效的纳管账号信息。

GET https://{endpoint}/v1/managed-organization/managed-accounts

响应示例

状态码：200

请求成功。

{
  "managed_accounts" : [ {
    "landing_zone_version" : "string",
    "manage_account_id" : "string",
    "account_id" : "string",
    "account_type" : "string",
    "owner" : "string",
    "state" : "string",
    "message" : "string",
    "parent_organizational_unit_id" : "string",
    "parent_organizational_unit_name" : "string",
    "identity_store_user_name" : "string",
    "blueprint_product_id" : "string",
    "blueprint_product_version" : "string",
    "blueprint_status" : "string",
    "is_blueprint_has_multi_account_resource" : "boolean",
    "regions" : [ {
      "region" : "string",
      "region_status" : "string"
    } ],
    "created_at" : "2023-11-15T07:37:15.243Z",
    "updated_at" : "2023-11-15T07:37:15.243Z"
  } ],
  "page_info" : {
    "next_marker" : "string",
    "current_count" : 1
  }
}

状态码

状态码

描述

200

请求成功。

403

请求无权限。

错误码

请参见错误码。

父主题：组织管理