全部產品
Search

搜尋本產品

    Resource Orchestration Service：CreateTemplate - 建立自訂模板

    文件中心

    Resource Orchestration Service：CreateTemplate - 建立自訂模板

    更新時間：Jun 04, 2026

    建立自訂的模板。

    介面說明

    本文將提供一個樣本，在杭州地區cn-hangzhou建立一個名為MyTemplate的模板，並將模板的結構TemplateBody設定為{"ROSTemplateFormatVersion": "2015-09-01"}。

    調試

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

    調試

    授權資訊

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

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ros:CreateTemplate

    create

    *Template

    acs:ros:{#regionId}:{#accountId}:template/*

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    TemplateURL

    string

    否

    包含模板主體的檔案的位置。URL 必須指向位於 Web 服務器（HTTP 或 HTTPS）或阿里雲 OSS 儲存空間（例如：oss://ros/stack-policy/demo、oss://ros/stack-policy/demo?RegionId=cn-hangzhou）中的模板。 模板長度範圍為 1~1024 位元組。 如未指定 OSS 地區，預設與介面參數 RegionId 相同。

    說明

    您必須且僅能指定 TemplateBody 和 TemplateURL 其中一個參數。

    oss://ros/template/demo
    Description

    string

    否

    模板的描述。最大長度為 256 個字元。

    It is a demo.
    TemplateBody

    string

    否

    模板主體的結構。長度為 1~524,288 個位元組。 如果長度較大，建議通過 HTTP POST+Body Param 的方式，將參數放在請求體中進行傳遞，避免 URL 過長而導致請求失敗。

    說明

    您僅能指定 TemplateBody、TemplateURL 或 TemplateId 其中一個參數。

    {"ROSTemplateFormatVersion":"2015-09-01"}
    TemplateName

    string

    是

    模板的名稱。 長度不超過 255 個字元（utf-8 編碼），必須以數字、英文字母或中文開頭，可包含數字、英文字母、中文、短劃線（-）和底線（_）。

    MyTemplate
    ResourceGroupId

    string

    否

    資源群組 ID。
    關於資源群組的更多資訊，請參見什麼是資源群組。

    rg-acfmxazb4ph6aiy****
    Tags

    array<object>

    否

    模板的標籤。

    object

    否

    模板的標籤。

    Key

    string

    是

    模板的標籤鍵。

    說明

    Tags 為選擇性參數。如果需要指定 Tags，則 Tags.N.Key 必須指定。

    usage
    Value

    string

    否

    模板的標籤值。

    test
    ValidationOptions

    array

    否

    校正選項。

    預設不啟用任何選項，進行嚴格校正。

    string

    否

    校正選項。取值：

    • BasicValidation：只對模板內容進行基礎的結構校正。

    BasicValidation

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

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    8C5D90E1-66B6-496C-9371-3807F8DA80A8
    TemplateId

    string

    模板 ID。

    5ecd1e10-b0e9-4389-a565-e4c15efc****

    樣本

    正常返回樣本

    JSON格式

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

    錯誤碼

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

    變更歷史

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