调用UpdatePolicyDescription更新自定义策略的描述信息。

使用说明

本API仅限更新自定义策略的描述信息,系统策略的描述信息不支持更新。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String UpdatePolicyDescription

要执行的操作。取值:UpdatePolicyDescription

PolicyName String TestPolicy

权限策略名称。

NewDescription String This is a test policy.

权限策略描述。

长度为1~1024个字符。

关于公共请求参数的详情,请参见公共参数

返回数据

名称 类型 示例值 描述
RequestId String 7572DEBD-0ECE-518E-8682-D8CB82F8FE8E

请求ID。

Policy Object

权限策略信息。

PolicyName String TestPolicy

权限策略名称。

PolicyType String Custom

权限策略类型。取值:

  • Custom:自定义策略。
  • System:系统策略。
CreateDate String 2022-02-28T07:04:15Z

权限策略创建时间。

UpdateDate String 2022-02-28T07:05:37Z

权限策略更新时间。

Description String This is a test policy.

权限策略描述。

DefaultVersion String v1

权限策略版本。默认值:v1。

示例

请求示例

https://ram.aliyuncs.com/?Action=UpdatePolicyDescription
&PolicyName=TestPolicy
&NewDescription=This is a test policy.
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdatePolicyDescriptionResponse>
    <Policy>
        <PolicyType>Custom</PolicyType>
        <UpdateDate>2022-02-28T07:05:37Z</UpdateDate>
        <Description>This is a test policy.</Description>
        <PolicyName>TestPolicy</PolicyName>
        <DefaultVersion>v1</DefaultVersion>
        <CreateDate>2022-02-28T07:04:15Z</CreateDate>
    </Policy>
    <RequestId>7572DEBD-0ECE-518E-8682-D8CB82F8FE8E</RequestId>
</UpdatePolicyDescriptionResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Policy" : {
    "PolicyType" : "Custom",
    "UpdateDate" : "2022-02-28T07:05:37Z",
    "Description" : "This is a test policy.",
    "PolicyName" : "TestPolicy",
    "DefaultVersion" : "v1",
    "CreateDate" : "2022-02-28T07:04:15Z"
  },
  "RequestId" : "7572DEBD-0ECE-518E-8682-D8CB82F8FE8E"
}

错误码

访问错误中心查看更多错误码。