创建策略
功能介绍
创建指定类型的策略。此操作只能由组织的管理账号调用。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v1/organizations/policies
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Security-Token |
否 |
String |
如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 最小值：1 |
X-Language |
否 |
String |
选择接口返回的信息的语言 枚举值：
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
content |
是 |
String |
要添加到新策略的策略文本内容。 最小长度：0 最大长度：20000 |
description |
是 |
String |
要分配给策略的可选说明。 最小长度：0 最大长度：512 |
name |
是 |
String |
要分配给策略的名称。 最小长度：1 最大长度：64 |
type |
是 |
String |
要创建的策略类型,service_control_policy服务控制策略；tag_policy：标签策略。 枚举值：
|
tags |
否 |
Array of TagDto objects |
要附加到新创建的策略的标签列表。 数组长度：0 - 20 |
响应参数
状态码： 201
参数 |
参数类型 |
描述 |
|---|---|---|
policy |
PolicyDto object |
包含有关策略的详细信息的结构。 |
参数 |
参数类型 |
描述 |
|---|---|---|
content |
String |
策略的文本内容。 最小长度：0 最大长度：20000 |
policy_summary |
PolicySummaryDto object |
包含有关策略的信息，但不包括内容。 |
参数 |
参数类型 |
描述 |
|---|---|---|
is_builtin |
Boolean |
一个布尔值，指示指定的策略是否为系统策略。如果为true，即为系统策略，则可以将策略附加到根、组织单元或账号，但不能编辑它。 |
description |
String |
策略说明。 最大长度：512 |
id |
String |
策略的唯一标识符（ID）。 最小长度：1 最大长度：130 |
urn |
String |
策略的统一资源名称。 最小长度：1 最大长度：1500 |
name |
String |
策略的名称。 最小长度：1 最大长度：64 |
type |
String |
策略的类型,service_control_policy：服务控制策略；tag_policy：标签策略。 最小长度：1 最大长度：64 |
请求示例
创建策略
POST https://{hostname}/v1/organizations/policies
{
"content" : "{\"Version\":\"5.0\",\"Statement\":[{\"Sid\":\"Statement1\",\"Effect\":\"Allow\",\"Action\":[\"*\"],\"Resource\":[\"*\"]}]}",
"description" : "auto0923160642938XHxSPolicydesc",
"name" : "auto092316064293806EYPolicyName",
"type" : "service_control_policy",
"tags" : [ {
"key" : "keystring",
"value" : "valuestring"
} ]
}
响应示例
状态码： 201
Successful.
{
"policy" : {
"content" : "{\"Version\":\"5.0\",\"Statement\":[{\"Sid\":\"Statement1\",\"Effect\":\"Allow\",\"Action\":[\"*\"],\"Resource\":[\"*\"]}]}",
"policy_summary" : {
"is_builtin" : false,
"description" : "auto0923160642938XHxSPolicydesc",
"id" : "p-b4wpejd02o66g0pvfinvsatp4t9krfum",
"urn" : "organizations::0a6d25d23900d45c0faac010e0fb4de0:policy:o-fhkmi6mek7wlqdp6nideqhb47qwtjdsv/service_control_policy/p-b4wpejd02o66g0pvfinvsatp4t9krfum",
"name" : "auto092316064293806EYPolicyName",
"type" : "service_control_policy"
}
}
}
状态码
状态码 |
描述 |
|---|---|
201 |
Successful. |
错误码
请参见错误码。
