資源棧建立失敗後調用ContinueCreateStack繼續建立-Resource Orchestration Service-阿里雲 - Resource Orchestration Service

資源棧建立失敗後，繼續建立資源棧。

介面說明

本文將提供一個樣本，對杭州地區 ID 為4a6c9851-3b0f-4f5f-b4ca-a14bf691****的建立失敗的資源棧進行繼續建立。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

ros:ContinueCreateStack

update

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
StackId	string	是	資源棧 ID。	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
RegionId	string	是	資源棧所屬的地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。	cn-hangzhou
RamRoleName	string	否	RAM 角色名稱。ROS 會扮演該角色建立資源棧，使用角色的憑證代表使用者進行介面調用。 ROS 始終將此角色用於資源棧上將進行的操作。只要使用者有權在資源棧上進行操作，即使使用者無權使用角色，ROS 也會使用此角色，確保角色授予最少的許可權。如果使用者未指定該值，ROS 將使用以前與資源棧關聯的角色。如果沒有可用角色，ROS 將使用從您的使用者憑證中產生的臨時憑證。 RAM 角色名稱最大長度為 64 個位元組。	test-role
Mode	string	否	繼續建立模式，取值： Recreate（預設值）：您僅需繼續建立如下 4 類資源，其它資源無需繼續建立：建立失敗的資源。指定繼續建立的資源（RecreatingResources.N）。依賴於指定繼續建立的資源（RecreatingResources.N）的資源。未建立的資源。說明 RecreatingResources.N、TemplateBody、TemplateURL、Parameters 參數僅在此模式下生效。 Ignore：忽略並丟棄所有建立失敗的資源、未建立的資源，直接把資源棧標記為成功。模板內容會發生變化。說明該模式僅 ROS 類型資源棧可用。	Recreate
TemplateBody	string	否	模板的結構。長度為 1~524288 個位元組。如果長度較大，建議通過 HTTP POST+Body Param 的方式，將參數放在請求體中進行傳遞，避免 URL 過長而導致請求失敗。 ROS 模板限制如下：只能修改模板的 Description、Metadata、Resources、Outputs、Rules 部分。不能增加或刪除 Section（模板內容的第一層）。模板的 Resources 部分限制如下：對於不繼續建立的資源，既不能刪除，也不能修改其模板內容。對於繼續建立的資源，既可以刪除，也可以修改其模板內容。可以增加新資源。說明該參數僅在 Mode 為 Recreate 時生效。您僅能指定 TemplateBody、TemplateURL 或 TemplateId 其中一個參數。若都不指定，則使用原有模板。	{"ROSTemplateFormatVersion": "2015-09-01"}
TemplateURL	string	否	包含模板主體的檔案的位置。URL 必須指向位於 Web 服務器（HTTP 或 HTTPS）或阿里雲 OSS 儲存桶（例如：oss://ros/template/demo、oss://ros/template/demo?RegionId=cn-hangzhou）中的模板，模板最大為 524288 個位元組。如果 OSS 地區未指定，預設與介面參數 RegionId 相同。說明該參數僅在 Mode 為 Recreate 時生效，模板限制與 TemplateBody 相同。您僅能指定 TemplateBody、TemplateURL 或 TemplateId 其中一個參數。若都不指定，則使用原有模板。	oss://ros-template/demo
DryRun	boolean	否	此次請求是否只進行檢驗。取值： true：只做校正，不會實際執行。 false（預設）：會實際執行，繼續建立資源棧。	false
TemplateId	string	否	模板 ID。支援共用模板和私人模板。說明當`Mode`取值為`Recreate`時，本參數生效。模板限制與`TemplateBody`相同。您僅能指定`TemplateBody`、`TemplateURL`或`TemplateId`其中一個參數。若都不指定，則使用原有模板。	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	否	模板版本。僅在指定 TemplateId 時生效。	v1
RecreatingResources	array	否	建立失敗的資源將會被繼續建立。您可以指定額外需要繼續建立的資源清單，ROS 會繼續建立所有依賴於其的資源。說明該參數僅 ROS 類型資源棧可用。	WebServer
	string	否	建立失敗的資源將會被繼續建立。您可以指定額外需要繼續建立的資源清單，ROS 會繼續建立所有依賴於其的資源。說明該參數僅在 ROS 類型的資源棧中可用。	WebServer
Parameters	array<object>	否	覆蓋的模板參數。
	object	否
ParameterKey	string	是	覆蓋的模板參數的名稱。如果未指定特定參數的名稱和值，ROS 將使用上一次建立時的取值。N 的最大值為 200。說明該參數僅在 Mode 為 Recreate 時生效。	Amount
ParameterValue	string	是	覆蓋的模板參數的值。N 的最大值為 200。對於 ROS 類型資源棧，覆蓋的模板參數限制如下：不能引發模板 Conditions 部分中任何 Condition 的值的變化，由 true 變 false，或由 false 變 true。覆蓋參數不能被不繼續建立的資源引用。說明該參數僅在 Mode 為 Recreate 時生效。	12
Parallelism	integer	否	資源最大並發數。預設為空白，使用者可以輸入大於等於零的整數。說明若設定為大於零的整數，則使用該整數。若設定為零，對於 ROS 類型資源棧則不限制，Terraform 類型資源棧使用 Terraform 預設值（通常為 10）。若不設定，則使用上次操作時的設定；若上次操作時未設定，對於 ROS 類型資源棧則不限制，Terraform 類型資源棧使用 Terraform 預設值（通常為 10）。若設定了該值，將與資源棧進行關聯，影響資源棧的後續操作。	1
RecreatingOptions	array	否	重新建立選項。
	string	否	重新建立選項。當`Mode`取值為`Recreate`時，本參數生效。可選值： TryToFixSignalFailureByRerunEcsCommand：嘗試修複已存在的訊號失敗。當 ALIYUN::ROS::WaitCondition 類型資源建立失敗時，找到與之關聯且建立成功的 ALIYUN::ECS::RunCommand 和 ALIYUN::ECS::Invocation 類型的資源，對這些資源及依賴其的資源進行重建。說明僅對 ROS 類型的資源棧生效。 IgnoreExistingSignalFailure：忽略已存在的訊號失敗。如果之前存在建立失敗的 ALIYUN::ROS::WaitCondition 類型的資源，新一次的建立過程中會直接建立成功。說明僅對 ROS 類型的資源棧生效。 AutoRecreatingResources：自動重新建立模板內容或引用參數發生變化的資源，包括依賴其的資源。使用該選項，可以簡化 RecreatingResources.N 參數的設定，但也可能造成意料之外的資源重建。說明僅對 ROS 類型的資源棧生效。 CreateNewPrepaidInstance：當您繼續建立執行個體時，對於建立失敗或建立成功但指定要重新建立的資源，如果該資源是預付費類型，ROS 會建立一個新執行個體。說明僅對 ROS 類型的資源棧生效。如果您已建立舊執行個體，則該執行個體不會被刪除，因為預付費執行個體無法刪除。預設情況下（未設定 CreateNewPrepaidInstance），在該情境中，如果已建立舊執行個體，則 ROS 會嘗試複用已建立的執行個體。複用存在一定的限制，資源屬性通常不允許修改或只有少量屬性允許修改。	CreateNewPrepaidInstance

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

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	B288A0BE-D927-4888-B0F7-B35EF84B6E6
StackId	string	資源棧 ID。	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
DryRunResult	object	校正結果。
ParametersAllowedToBeModified	array	允許修改的參數。
	string	允許修改的參數。修改參數不會引發校正錯誤。說明僅在 DryRun 為`true`時返回，結果與 Mode、Template*、RecreatingResources.N、RecreatingOptions.N 相關。	description
ParametersConditionallyAllowedToBeModified	array	可能允許修改的參數。
	string	可能允許修改的參數。修改參數是否引起校正錯誤，取決於參數的取值。說明僅在 DryRun 為`true`時返回，結果與 Mode、Template*、RecreatingResources.N、RecreatingOptions.N 相關。	name
ParametersNotAllowedToBeModified	array	不允許修改的參數。
	string	不允許修改的參數。修改參數一定會引發校正錯誤。說明僅在 DryRun 為`true`時返回，結果與 Mode、Template*、RecreatingResources.N、RecreatingOptions.N 相關。	cidr

樣本

正常返回樣本

JSON格式

{
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6",
  "StackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf691****",
  "DryRunResult": {
    "ParametersAllowedToBeModified": [
      "description"
    ],
    "ParametersConditionallyAllowedToBeModified": [
      "name"
    ],
    "ParametersNotAllowedToBeModified": [
      "cidr"
    ]
  }
}

錯誤碼

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

變更歷史

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