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

功能介绍

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

授权信息

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

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
rgc:controlsForAccount:list	List	-	-	-	-

URI

GET /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
  }
}