調用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"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。