更新組態套件
更新組態套件,以建立變更組態的新不可變版本。每次更新都會產生新的版本 ID;不會修改現有的版本。版本會透過 形成鏈結parentVersionIds,類似於 git 遞交。
程式碼範例
範例
請求參數
| 參數 | Type | 必要 | 描述 |
|---|---|---|---|
|
|
String |
是 |
要更新的組態套件 ID。以路徑參數傳遞。 |
|
|
String |
否 |
已更新套件的名稱。 |
|
|
String |
否 |
已更新描述。最多 500 個字元。 |
|
|
Map |
否 |
已更新元件組態。使用這些元件建立新的版本。 |
|
|
字串清單 |
否 |
用於歷程追蹤的父版本 IDs。更新 時為必要 |
|
|
String |
否 |
此版本的分支名稱。如果未指定, 會繼承父系的分支或預設為 |
|
|
String |
否 |
遞交說明變更的訊息。最多 500 個字元。 |
|
|
物件 |
否 |
建立此版本的來源。包含 |
|
|
String |
否 |
等冪性字符。 |
回應
| 欄位 | Type | Description |
|---|---|---|
|
|
String |
組態套件的 ARN。 |
|
|
String |
組態套件的 ID。 |
|
|
String |
此更新所建立新版本的 UUID。 |
|
|
時間戳記 |
套用更新的時間。 |
分支和合併
組態套件支援類似 git 的分支:
-
線性遞交。省略
parentVersionIds或傳遞單一父系。新版本擴展分支歷程。 -
新的分支。指定尚不存在
branchName的 ,並parentVersionIds指向您要分支的版本。 -
合併遞交。傳遞兩個
parentVersionIds:第一個是目標分支的最新版本,第二個是來源分支的最新版本。這會在目標分支上建立合併遞交。
錯誤
| 錯誤 | HTTP 狀態 | 說明 |
|---|---|---|
|
|
400 |
無效的請求參數。檢查欄位限制條件。 |
|
|
404 |
指定的 |
|
|
409 |
版本衝突。指定的父版本不是分支上的最新版本。擷取最新版本並重試。 |
|
|
403 |
許可不足。驗證 IAM 政策是否包含 |
|
|
429 |
超過請求率。以指數退避重試。 |
|
|
500 |
服務端錯誤。重試 請求。 |