指定LaunchTemplateId、DeleteVersion等參數,刪除指定執行個體啟動範本的一個或多個版本。
介面說明
呼叫該介面時,您需要注意:
-
不支援刪除預設版本,您必須通過刪除整個執行個體啟動範本才能刪除預設版本。
-
如果您需要刪除的版本為預設版本,可以通過呼叫 ModifyLaunchTemplateDefaultVersion 或在啟動範本控制台切換預設版本以後,進行刪除操作。
-
刪除版本不會影響通過該版本已建立的執行個體。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
ecs:DeleteLaunchTemplateVersion |
delete |
*LaunchTemplate
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
是 |
範本所屬的地域 ID。您可以呼叫 DescribeRegions 查看最新的阿里雲地域列表。 |
cn-hangzhou |
| DeleteVersion |
array |
是 |
待刪除的範本版本號。 |
2 |
|
integer |
否 |
範本版本號,N 的取值範圍 1~29。您可以呼叫 DescribeLaunchTemplateVersions 查詢啟動範本版本號列表。 |
2 |
|
| LaunchTemplateId |
string |
否 |
需要刪除的啟動範本 ID。更多資訊,請參見 DescribeLaunchTemplates 。 |
lt-bp1apo0bbbkuy0rj**** |
| LaunchTemplateName |
string |
否 |
啟動範本名稱。 |
testLaunchTemplateName |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
| LaunchTemplateVersions |
object |
||
| LaunchTemplateVersion |
array<object> |
已刪除的執行個體啟動範本版本。 |
|
|
object |
|||
| LaunchTemplateId |
string |
執行個體啟動模板 ID。 |
lt-bp1apo0bbbkuy0rj**** |
| LaunchTemplateVersionNumber |
integer |
執行個體啟動模板版本號碼。 |
2 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"LaunchTemplateVersions": {
"LaunchTemplateVersion": [
{
"LaunchTemplateId": "lt-bp1apo0bbbkuy0rj****",
"LaunchTemplateVersionNumber": 2
}
]
}
}
異常返回樣本
JSON格式
{
"RequestId": "04F0F334-1335-436C-A1D7-6C044FExxxxx",
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | InvalidRegion.NotExist | %s | |
| 400 | MissingParameter | %s | |
| 400 | InvalidParameter | %s | |
| 403 | InvalidOperation.DeleteDefaultVersion | %s | |
| 403 | InnerServiceFailed | %s |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。