全部產品
Search

搜尋本產品

    Resource Orchestration Service：UpdateStackTemplateByResources - 修正資源棧模板

    文件中心

    Resource Orchestration Service：UpdateStackTemplateByResources - 修正資源棧模板

    更新時間：Dec 16, 2025

    通過執行偏差檢測，消除資源棧的偏差。

    介面說明

    使用限制：只能對偏差狀態（DRIFTED）的資源棧進行消除偏差。您需要先調用 DetectStackDrift 介面對資源棧進行偏差檢測，然後調用 GetStackDriftDetectionStatus 介面查詢資源棧偏差狀態，確保資源棧處於偏差（DRIFTED）狀態，最後調用 UpdateStackTemplateByResources 介面消除偏差。

    本文將提供一個樣本，為杭州地區資源棧 ID 為4a6c9851-3b0f-4f5f-b4ca-a14bf691****的資源棧消除偏差。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ros:UpdateStackTemplateByResources

    update

    *stack

    acs:ros:{#regionId}:{#accountId}:stack/{#stackId}

    		 無 無

    請求文法

    POST /V2/UpdateStackTemplateByResources HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    StackId

    string

    是

    資源棧 ID。

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****
    DryRun

    boolean

    否

    此次請求是否只預覽結果，取值：

    • true：返回修正後的資源棧的模板的內容，並不會修改資源棧的模板。與原模板比較分析後，再判斷是否要執行修正。

    • false（預設值）：會直接對資源棧的模板進行修正以消除偏差。

    說明

    建議設定 DryRun 為 true，預覽修改後的模板。如果符合預期，再設定 DryRun 為 false，真正地執行修改。

    false
    RegionId

    string

    是

    資源棧所屬的地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。

    cn-hangzhou
    ClientToken

    string

    否

    保證請求的等冪性。 該值由用戶端產生，並且必須是全域唯一的。
    長度最大為 64 個字元，可包含英文字元、數字、短劃線（-）和底線（_）。

    更多詳情，請參見如何保證等冪性。

    123e4567-e89b-12d3-a456-42665544****
    TemplateFormat

    string

    否

    返回的模板格式，取值：

    • JSON（預設值）

    • YAML

    JSON
    LogicalResourceId

    array

    否

    資源名列表，用於過濾資源。修正模板時僅涉及列表中的資源。預設修正所有有偏差的資源。

    如果被修正的列表中包含偏差狀態為 DELETED 的資源，為了確保修正後模板的正確性，可能會對列表之外但引用了被刪除資源的資源進行調整。

    Vpc

    string

    否

    資源名列表，用於過濾資源。修正模板時僅涉及列表中的資源。預設修正所有有偏差的資源。

    如果被修正的列表中包含偏差狀態為 DELETED 的資源，為了確保修正後模板的正確性，可能會對列表之外但引用了被刪除資源的資源進行調整。

    WebServer

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

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    B288A0BE-D927-4888-B0F7-B35EF84B6E6F
    NewTemplateBody

    string

    修正後的模板的內容。

    {\"ROSTemplateFormatVersion\": \"2015-09-01\", \"Resources\": {\"Vpc\": {\"Type\": \"ALIYUN::ECS::VPC\", \"Properties\": {\"VpcName\": \"test\", \"CidrBlock\": \"192.168.0.0/16\", \"Description\": \"test2\"}}}, \"Outputs\": {\"VpcId\": {\"Value\": {\"Fn::GetAtt\": [\"Vpc\", \"VpcId\"]}}}}
    OldTemplateBody

    string

    修正前的模板的內容。

    {\"ROSTemplateFormatVersion\": \"2015-09-01\", \"Resources\": {\"Vpc\": {\"Type\": \"ALIYUN::ECS::VPC\", \"Properties\": {\"VpcName\": \"test\", \"CidrBlock\": \"192.168.0.0/16\", \"Description\": \"test1\"}}}, \"Outputs\": {\"VpcId\": {\"Value\": {\"Fn::GetAtt\": [\"Vpc\", \"VpcId\"]}}}}

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6F",
  "NewTemplateBody": "{\\\"ROSTemplateFormatVersion\\\": \\\"2015-09-01\\\", \\\"Resources\\\": {\\\"Vpc\\\": {\\\"Type\\\": \\\"ALIYUN::ECS::VPC\\\", \\\"Properties\\\": {\\\"VpcName\\\": \\\"test\\\", \\\"CidrBlock\\\": \\\"192.168.0.0/16\\\", \\\"Description\\\": \\\"test2\\\"}}}, \\\"Outputs\\\": {\\\"VpcId\\\": {\\\"Value\\\": {\\\"Fn::GetAtt\\\": [\\\"Vpc\\\", \\\"VpcId\\\"]}}}}",
  "OldTemplateBody": "{\\\"ROSTemplateFormatVersion\\\": \\\"2015-09-01\\\", \\\"Resources\\\": {\\\"Vpc\\\": {\\\"Type\\\": \\\"ALIYUN::ECS::VPC\\\", \\\"Properties\\\": {\\\"VpcName\\\": \\\"test\\\", \\\"CidrBlock\\\": \\\"192.168.0.0/16\\\", \\\"Description\\\": \\\"test1\\\"}}}, \\\"Outputs\\\": {\\\"VpcId\\\": {\\\"Value\\\": {\\\"Fn::GetAtt\\\": [\\\"Vpc\\\", \\\"VpcId\\\"]}}}}"
}

    錯誤碼

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

    變更歷史

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