文档首页/ 资源治理中心 RGC/ API参考/ API/ Landing Zone治理/ 列出注册OU下开启的控制策略
更新时间：2024-10-26 GMT+08:00
查看PDF
分享

列出注册OU下开启的控制策略

功能介绍

列出组织里某个注册OU开启的所有控制策略信息。

URI

GET https://{hostname}/v1/governance/managed-organizational-units/{managed_organizational_unit_id}/controls

表1 路径参数

参数

是否必选

参数类型

描述

managed_organizational_unit_id

是

String

注册OU 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

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

regional_preference

String

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

guidance

String

控制策略必须性。

service

String

控制策略所属服务。

implementation

String

服务控制策略（SCP），配置规则。
表5 PageInfoDto

参数

参数类型

描述

next_marker

String

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

current_count

Integer

本页返回条目数量。

请求示例

列出组织里某个注册OU开启的所有控制策略信息。

GET https://{endpoint}/v1/governance/managed-organizational-units/{managed_organizational_unit_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",
    "implementation" : "string"
  } ],
  "page_info" : {
    "next_marker" : "string",
    "current_count" : 0
  }
}

状态码

状态码

描述

200

请求成功。

错误码

请参见错误码。

父主题： Landing Zone治理

相关文档