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~6144个字符。关于权限策略元素和示例，请参见权限策略基本元素和权限策略示例库。

返回数据


名称	类型	示例值	描述
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"
}

错误码

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