文档首页/ 资源治理中心 RGC/ API参考/ API/ Landing Zone治理/ 列出纳管账号下开启的控制策略
更新时间:2025-08-22 GMT+08:00

列出纳管账号下开启的控制策略

功能介绍

列出组织里某个纳管账号开启的所有控制策略信息。

URI

GET https://{endpoint}/v1/governance/managed-accounts/{managed_account_id}/controls

表1 路径参数

参数

是否必选

参数类型

描述

managed_account_id

String

纳管账号ID。

表2 Query参数

参数

是否必选

参数类型

描述

limit

Integer

分页页面的最大值。

marker

String

页面标记。

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

control_summaries

Array of TargetControl objects

治理策略概要。

page_info

PageInfoDto object

本页返回条目数量。

表4 TargetControl

参数

参数类型

描述

manage_account_id

String

管理员账号ID。

control_identifier

String

控制策略标识。

state

String

控制策略启用状态。

version

String

控制策略当前版本号。

name

String

控制策略名称。

description

String

控制策略描述信息。

control_objective

String

控制策略目标。

behavior

String

控制策略类型。包括主动性控制策略Proactive、检测性控制策略Detective、预防性控制策略Preventive。

owner

String

控制策略来源。

regional_preference

String

区域选项,取值有两种分别是:区域的regional和全局的global。

guidance

String

控制策略必须性。

service

String

控制策略所属服务。

implementation

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/governance/managed-accounts/{managed_account_id}/controls

响应示例

状态码:200

请求成功。

{
  "control_summaries" : [ {
    "manage_account_id" : "string",
    "control_identifier" : "string",
    "state" : "string",
    "version" : "string",
    "name" : "string",
    "description" : "string",
    "control_objective" : "string",
    "behavior" : "string",
    "owner" : "string",
    "regional_preference" : "string",
    "guidance" : "string",
    "service" : "string"
  } ],
  "page_info" : {
    "next_marker" : "string",
    "current_count" : 0
  }
}

状态码

状态码

描述

200

请求成功。

403

请求无权限。

错误码

请参见错误码