調用UpdateTemplate介面更新Resource Orchestration Service模板-Resource Orchestration Service-阿里雲 - Resource Orchestration Service

介面說明

更新模板時，請注意：

如果指定了 TemplateBody 或 TemplateURL，更新模板成功後，模板版本加 1。例如：版本由 v1 變為 v2。
如果未指定 TemplateBody 和 TemplateURL，模板版本不變。
模板最多擁有 100 個版本。如果版本達到上限，模板將更新失敗，您需要重新建立模板。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ros:UpdateTemplate

update

*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 其中一個參數。 URL 的最大長度為：1024 個位元組。	oss://ros/template/demo
TemplateName	string	否	模板的名稱。長度不超過 255 個字元（utf-8 編碼），必須以數字、英文字母或中文開頭，可包含數字、英文字母、中文、短劃線（-）和底線（_）。	MyTemplate
Description	string	否	模板的描述。最大長度為 256 個字元。	It is a demo.
TemplateBody	string	否	模板主體的結構。長度為 1~524,288 個位元組。如果長度較長，則建議通過 HTTP POST+Body Param 的方式，將參數放在請求體中進行傳遞，避免因 URL 過長而導致請求失敗。說明您必須且僅能指定 TemplateBody、TemplateURL、TemplateId 和 TemplateScratchId 其中一個參數。	{"ROSTemplateFormatVersion":"2015-09-01"}
TemplateId	string	是	模板 ID。支援共用模板和私人模板。	5ecd1e10-b0e9-4389-a565-e4c15efc****
ValidationOptions	array	否	校正選項。預設不啟用任何選項，進行嚴格校正。
	string	否	校正選項。取值： BasicValidation：只對模板內容進行基本的結構校正。	BasicValidation
RotateStrategy	string	否	模板版本輪轉策略。取值： None（預設值）：不輪轉。模板版本數量達到上限時報錯。 DeleteOldestNonSharedVersionWhenLimitExceeded：轉輪刪除未共用的模板版本。說明如果模板共用了所有版本，則無法輪轉刪除。當前的最新版本不會被轉輪刪除。無論是否使用了輪轉刪除，模板版本號碼無法超過 v65000。	None
IsDraft	boolean	否	是否更新 Draft（草稿）版本。取值： false（預設值）：如果傳遞了模板內容，則會建立一個新版本，並清除 Draft 版本。否則修改當前最新版本。 true：修改更新 Draft 版本。Draft 版本只能通過 GetTemplate 介面擷取。ListTemplateVersions 介面不會返回。其他介面的 TemplateVersion 參數也不能指定 Draft。	false

關於公用請求參數的詳情，請參見公用參數。

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	8C5D90E1-66B6-496C-9371-3807F8DA80A8
TemplateId	string	模板 ID。	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	本次操作所作用的模板版本。	v2

樣本

正常返回樣本

JSON格式

{
  "RequestId": "8C5D90E1-66B6-496C-9371-3807F8DA80A8",
  "TemplateId": "5ecd1e10-b0e9-4389-a565-e4c15efc****",
  "TemplateVersion": "v2"
}

錯誤碼

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

變更歷史

更多資訊，參考變更詳情。