調用UpdateControlPolicy修改自定義管控策略。
使用說明
本文將提供一個示例,修改管控策略cp-jExXAqIYkwHN****
的名稱為NewControlPolicy
。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpdateControlPolicy |
要執行的操作。取值:UpdateControlPolicy。 |
PolicyId | String | 是 | cp-jExXAqIYkwHN**** |
管控策略ID。 |
NewPolicyName | String | 否 | NewControlPolicy |
新的管控策略名稱。 長度為1~128個字符,必須以英文字母開頭,可以包含英文字母、數字和短劃線(-)。 |
NewDescription | String | 否 | ExampleControlPolicy |
新的管控策略描述。 長度為1~1024個字符,必須以英文字母開頭,可以包含英文字母、數字、下劃線(_)和短劃線(-)。 |
NewPolicyDocument | String | 否 | {"Version":"1","Statement":[{"Effect":"Deny","Action":["ram:UpdateRole","ram:DeleteRole","ram:AttachPolicyToRole","ram:DetachPolicyFromRole"],"Resource":"acs:ram:*:*:role/ResourceDirectoryAccountAccessRole"}]} |
新的管控策略內容。 最大長度為4096個字符。 管控策略語言,請參見管控策略語言。 管控策略示例,請參見自定義管控策略示例。 |
關于公共請求參數的詳情,請參見公共參數。
返回數據
名稱 | 類型 | 示例值 | 描述 |
---|---|---|---|
ControlPolicy | Object |
管控策略詳情。 |
|
UpdateDate | String | 2021-03-18T10:04:55Z |
管控策略更新時間。 |
Description | String | ExampleControlPolicy |
管控策略描述。 |
EffectScope | String | RAM |
管控策略生效范圍。取值:
|
AttachmentCount | String | 0 |
管控策略被引用的次數。 |
PolicyName | String | NewControlPolicy |
管控策略名稱。 |
PolicyId | String | cp-jExXAqIYkwHN**** |
管控策略ID。 |
CreateDate | String | 2021-03-18T09:24:19Z |
管控策略創建時間。 |
PolicyType | String | Custom |
管控策略類型。取值:
|
RequestId | String | 2DFCE4C9-04A9-4C83-BB14-FE791275EC53 |
請求ID。 |
示例
請求示例
https://resourcemanager.aliyuncs.com/?Action=UpdateControlPolicy
&PolicyId=cp-jExXAqIYkwHN****
&NewPolicyName=NewControlPolicy
&<公共請求參數>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<UpdateControlPolicyResponse>
<ControlPolicy>
<PolicyType>Custom</PolicyType>
<UpdateDate>2021-03-18T10:04:55Z</UpdateDate>
<Description>ExampleControlPolicy</Description>
<AttachmentCount>0</AttachmentCount>
<PolicyName>NewControlPolicy</PolicyName>
<CreateDate>2021-03-18T09:24:19Z</CreateDate>
<PolicyId>cp-jExXAqIYkwHN****</PolicyId>
<EffectScope>RAM</EffectScope>
</ControlPolicy>
<RequestId>2DFCE4C9-04A9-4C83-BB14-FE791275EC53</RequestId>
</UpdateControlPolicyResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"ControlPolicy" : {
"PolicyType" : "Custom",
"UpdateDate" : "2021-03-18T10:04:55Z",
"Description" : "ExampleControlPolicy",
"AttachmentCount" : 0,
"PolicyName" : "NewControlPolicy",
"CreateDate" : "2021-03-18T09:24:19Z",
"PolicyId" : "cp-jExXAqIYkwHN****",
"EffectScope" : "RAM"
},
"RequestId" : "2DFCE4C9-04A9-4C83-BB14-FE791275EC53"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。