更新时间：2024-10-21 GMT+08:00
更新策略
功能介绍
更新策略，可以更新策略的名称、描述或内容。如果不提供任何参数，则策略将保持不变。您不能更改策略的类型。此操作只能由组织的管理账号调用。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
PATCH https://{endpoint}/v1/organizations/policies/{policy_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
policy_id |
是 |
String |
策略的唯一标识符（ID）。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Security-Token |
否 |
String |
如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 |
|
X-Language |
否 |
String |
选择接口返回的信息的语言 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
content |
否 |
String |
要添加到新策略的策略文本内容。 |
|
description |
否 |
String |
要分配给策略的可选说明。 |
|
name |
否 |
String |
要分配给策略的名称。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
policy |
PolicyDto object |
包含有关策略的详细信息的结构。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
content |
String |
策略的文本内容。 |
|
policy_summary |
PolicySummaryDto object |
包含有关策略的信息，但不包括内容。 |
请求示例
更新策略
PATCH https://{endpoint}/v1/organizations/policies/{policy_id}
{
"content" : "{\"Version\":\"5.0\",\"Statement\":[{\"Sid\":\"Statement1\",\"Effect\":\"Allow\",\"Action\":[\"*\"],\"Resource\":[\"*\"]}]}",
"description" : "newdesc",
"name" : "auto09231619598990t1HPolicyName"
}
响应示例
状态码： 200
Successful.
{
"policy" : {
"content" : "{\"Version\":\"5.0\",\"Statement\":[{\"Sid\":\"Statement1\",\"Effect\":\"Allow\",\"Action\":[\"*\"],\"Resource\":[\"*\"]}]}",
"policy_summary" : {
"is_builtin" : false,
"description" : "newdesc",
"id" : "p-xce633owqm0o1c929wno7l850z2rdr4m",
"urn" : "organizations::0a6d25d23900d45c0faac010e0fb4de0:policy:o-fhkmi6mek7wlqdp6nideqhb47qwtjdsv/service_control_policy/p-b4wpejd02o66g0pvfinvsatp4t9krfum",
"name" : "auto09231619598990t1HPolicyName",
"type" : "service_control_policy"
}
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
Successful. |
错误码
请参见错误码。
父主题： 策略管理
