调用CreatePolicy接口创建一个自定义权限策略。

关于权限策略的介绍，请参见权限策略概览。

本文将提供一个示例，创建一个权限策略，用来查看指定地域的ECS实例。

调试

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

请求参数

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

要执行的操作。取值：CreatePolicy。

PolicyName String 是 View-ECS-instances-in-a-specific-region

权限策略名称。

长度为1~128个字符，可包含英文字母、数字和短划线（-）。
Description String 否 查看指定地域ECS实例

权限策略描述。

长度为1~1024个字符。
PolicyDocument String 是 {"Statement": [{"Effect": "Allow","Action": "ecs:Describe*","Resource": "acs:ecs:cn-qingdao:*:instance/*"}],"Version": "1"}

权限策略内容。

长度为1~2048个字符。

关于权限策略元素和示例，请参见权限策略基本元素和权限策略示例库。

返回数据

名称 类型 示例值 描述
Policy Object

权限策略信息。
DefaultVersion String v1

权限策略版本。默认值：v1。
Description String 查看指定地域ECS实例

权限策略描述。
PolicyName String View-ECS-instances-in-a-specific-region

权限策略名称。
CreateDate String 2021-10-13T02:46:57Z

权限策略创建时间。
PolicyType String Custom

权限策略类型。取值：

  • Custom：自定义策略。
  • System：系统策略。
RequestId String BA34C54A-C2B1-5A65-B6B0-B5842C1DB4DA

请求ID。

示例

请求示例

https://ram.aliyuncs.com/?Action=CreatePolicy
&PolicyName=View-ECS-instances-in-a-specific-region
&Description=查看指定地域ECS实例
&PolicyDocument={"Statement": [{"Effect": "Allow","Action": "ecs:Describe*","Resource": "acs:ecs:cn-qingdao:*:instance/*"}],"Version": "1"}
&公共请求参数

正常返回示例

XML格式 

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

<?xml version="1.0" encoding="UTF-8" ?>
<CreatePolicyResponse>
	<Policy>
		<PolicyType>Custom</PolicyType>
		<Description>查看指定地域ECS实例</Description>
		<DefaultVersion>v1</DefaultVersion>
		<PolicyName>View-ECS-instances-in-a-specific-region</PolicyName>
		<CreateDate>2021-10-13T02:46:57Z</CreateDate>
	</Policy>
	<RequestId>BA34C54A-C2B1-5A65-B6B0-B5842C1DB4DA</RequestId>
</CreatePolicyResponse>

JSON格式 

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

{
  "Policy" : {
    "PolicyType" : "Custom",
    "Description" : "查看指定地域ECS实例",
    "DefaultVersion" : "v1",
    "PolicyName" : "View-ECS-instances-in-a-specific-region",
    "CreateDate" : "2021-10-13T02:46:57Z"
  },
  "RequestId" : "BA34C54A-C2B1-5A65-B6B0-B5842C1DB4DA"
}

错误码

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