删除策略

最近更新时间:2017-12-21 21:18:00

删除策略(DeletePolicy)

描述

为主账户删除自定义策略

注1:删除策略时需要保证策略当前不被附加到任何实体上(IAM本期只有“用户”一种实体),且除默认策略版本外,其他策略版本均已被删除,即成功删除策略流程如下:

  1. 将欲删除的策略从用户上分离,使用DetachUserPolicy接口
  2. 将欲删除的策略除默认版本外的其他策略版本删除,使用DeletePolicyVersion接口
  3. 使用DeletePolicy接口完成策略删除动作(默认策略一并被删除)

注2:IAM系统内置的全局系统策略主账户不能删除

返回API概览

请求参数

名称 类型 必须 长度限制(字符) 参数格式 描述
Action String 确定值 [a-zA-Z]+ 操作接口名,系统规定参数,取值:DeletePolicy
PolicyKrn String 最短是25,最长2048 格式:krn:ksc:iam::account-id:policy/policy-name 待删除策略的唯一标识

返回元素(调用成功)

错误码(调用不成功)

错误代码(Code) 错误消息(Message) HTTP 状态码 中文描述(语义)
InvalidParameterValue An value must be supplied for the input parameter %s. 400 输入参数%s的值不能为空,具体参数名在%s说明
InvalidParameterValue An invalid or out-of-range value was supplied for the input parameter %s. 400 输入参数 %s的值无效、不合法或者超出范围,具体参数名在%s说明
PolicyDeleteConflict The request was rejected because it attempted to delete a 'Policy' that has attached subordinate entities. 409 请求被拒绝,因其欲删除具有附加实体的策略
PolicyNoSuchEntity The request was rejected because it referenced 'Policy' that does not exist. 404 请求被拒绝,因其引用的“策略”不存在

示例(调用成功)

请求示例
https://iam.api.ksyun.com?Action=DeletePolicy
&PolicyKrn=krn:ksc:iam::12345678901234567890:policy/IAMadmin
&公共请求参数
返回示例
  • XML格式
<DeletePolicyResponse>
    <ResponseMetadata>
        <RequestId>941610f5-5966-475b-a0f5-4b3102aa2619</RequestId>
    </ResponseMetadata>
</DeletePolicyResponse>
  • JSON示例
{
    "ResponseMetadata": {
        "RequestId": "184816ad-ba6a-44d5-abf6-9215971778bc"
    }
}

金山云,开启您的云计算之旅

注册有礼