通過指定模板生成模板所需的策略信息。
接口說明
如果模板所需的策略中包含企業級分布式應用服務 EDAS(Enterprise Distributed Application Service),您需要登錄阿里云賬號,對需要授權的 RAM 用戶進行 RAM 權限升級。
本文將提供一個示例,為您介紹如何為模板 ID 為5ecd1e10-b0e9-4389-a565-e4c15efc****
的模板生成權限策略。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
ros:GenerateTemplatePolicy | list | *Template acs:ros:{#regionId}:{#accountId}:template/{#TemplateId} |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
TemplateURL | string | 否 | 包含模板主體的文件的位置。URL 必須指向位于 Web 服務器(HTTP 或 HTTPS)或阿里云 OSS 存儲空間(例如:oss://ros/template/demo、oss://ros/template/demo?RegionId=cn-hangzhou)中的模板,模板最大為 524,288 個字節。 說明
如果 OSS 地域未指定,默認與接口參數 RegionId 相同。
您僅能指定 TemplateBody、TemplateURL、TemplateId 其中一個參數。 URL 的最大長度為:1024 個字節。 | oss://ros/template/demo |
TemplateBody | string | 否 | 模板的結構。長度為 1~524,288 個字節。 如果長度較大,建議通過 HTTP POST+Body Param 的方式,將參數放在請求體中進行傳遞,避免 URL 過長而導致請求失敗。 您僅能指定 TemplateBody、TemplateURL、TemplateId 其中一個參數。 | {"ROSTemplateFormatVersion":"2015-09-01"} |
TemplateId | string | 否 | 模板 ID。支持共享模板和私有模板。 | 5ecd1e10-b0e9-4389-a565-e4c15efc**** |
TemplateVersion | string | 否 | 模板版本。僅在指定 TemplateId 時生效。 | v1 |
OperationTypes | array | 否 | 需要生成策略信息的操作類型。 | |
string | 否 | 需要生成策略信息的操作類型。 取值:
說明
默認值為所有取值。
| ["CreateStack"] |
關于公共請求參數的詳情,請參見公共參數。
返回參數
示例
正常返回示例
JSON
格式
{
"Policy": {
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Resource": "*",
"Action": [
"[\n \"ram:PassRole\"\n]"
],
"Condition": {
"StringEquals": {
"acs:Service": "fc.aliyuncs.com"
}
}
}
]
},
"RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2023-06-02 | OpenAPI 返回結構發生變更 | 查看變更詳情 |
HttpCode | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | StackValidationFailed | {reason}. | 資源棧校驗失敗。reason 為具體原因。 |
404 | TemplateNotFound | The Tempalte ({ ID }) could not be found. | 模板不存在。ID 為模板 ID。 |
404 | TemplateNotFound | The Template { ID } with version { version } could not be found. | 模板或指定版本不存在。ID 為模板 ID,version 為模板版本。 |