列出注册OU下开启的控制策略
功能介绍
列出组织里某个注册OU开启的所有控制策略信息。
URI
GET /v1/governance/managed-organizational-units/{managed_organizational_unit_id}/controls
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
managed_organizational_unit_id |
是 |
String |
注册OU ID。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
limit |
否 |
Integer |
分页页面的最大值。 |
|
marker |
否 |
String |
页面标记。 |
请求参数
无
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
control_summaries |
Array of TargetControl objects |
治理策略概要。 |
|
page_info |
PageInfoDto object |
本页返回条目数量。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
策略类别。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
next_marker |
String |
在标签请求参数中使用以获取输出的下一部分。重复此操作,直到响应元素返回null。如果存在,则表示可用的输出比当前响应中包含的输出多。 |
|
current_count |
Integer |
本页返回条目数量。 |
状态码:403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误信息 |
|
request_id |
String |
请求唯一标识 |
|
encoded_authorization_message |
String |
加密的错误信息 |
|
details |
Array of ForbiddenErrorDetail objects |
跨服务调用无权限错误信息 |
请求示例
列出组织里某个注册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 |
请求成功。 |
|
403 |
请求无权限。 |
错误码
请参见错误码。