Virtual Machine Scale Sets - Reimage
對於虛擬機具有暫時 OS 磁碟的虛擬機,重新映像(升級作業系統)VM 擴展集中的一或多個虛擬機,虛擬機會重設為初始狀態。
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/reimage?api-version=2024-07-01
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
resource
|
path | True |
string |
資源群組的名稱。 |
subscription
|
path | True |
string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
vm
|
path | True |
string |
VM 擴展集的名稱。 |
api-version
|
query | True |
string |
用戶端 API 版本。 |
要求本文
名稱 | 類型 | Description |
---|---|---|
exactVersion |
string |
以十進位數指定作業系統磁碟應重新映像至的版本。 如果未提供確切版本,OS 磁碟會重新映像到現有的 OS 磁碟版本。 |
forceUpdateOSDiskForEphemeral |
boolean |
強制更新虛擬機擴展集 VM 暫時 OS 磁碟的參數 |
instanceIds |
string[] |
虛擬機擴展集實例標識碼。 省略虛擬機擴展集實例標識碼會導致作業在虛擬機擴展集的所有虛擬機上執行。 |
osProfile |
指定重新映像非暫時 OS 磁碟所需的資訊。 |
|
tempDisk |
boolean |
指定是否要重新設定暫存磁碟的映像。 默認值:false。 注意:只有具有暫時 OS 磁碟的 VM/VMSS 才支援此暫存磁碟重新映像參數。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
還行 |
|
202 Accepted |
接受 |
|
Other Status Codes |
描述作業失敗原因的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
名稱 | Description |
---|---|
user_impersonation | 模擬您的用戶帳戶 |
範例
Virtual |
Virtual |
VirtualMachineScaleSet_Reimage_MaximumSet_Gen
範例要求
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-07-01
{
"instanceIds": [
"aaaaaaaaaa"
],
"forceUpdateOSDiskForEphemeral": true,
"tempDisk": true
}
範例回覆
location: https://foo.com/operationstatus
VirtualMachineScaleSet_Reimage_MinimumSet_Gen
範例要求
範例回覆
location: https://foo.com/operationstatus
定義
名稱 | Description |
---|---|
Api |
Api 錯誤。 |
Api |
API 錯誤基底。 |
Cloud |
來自計算服務的錯誤回應。 |
Inner |
內部錯誤詳細數據。 |
OSProfile |
重新製作非暫時虛擬機映像的其他參數。 |
Virtual |
描述虛擬機擴展集 VM 重新映像參數。 |
ApiError
Api 錯誤。
名稱 | 類型 | Description |
---|---|---|
code |
string |
錯誤碼。 |
details |
Api 錯誤詳細數據 |
|
innererror |
Api 內部錯誤 |
|
message |
string |
錯誤訊息。 |
target |
string |
特定錯誤的目標。 |
ApiErrorBase
API 錯誤基底。
名稱 | 類型 | Description |
---|---|---|
code |
string |
錯誤碼。 |
message |
string |
錯誤訊息。 |
target |
string |
特定錯誤的目標。 |
CloudError
來自計算服務的錯誤回應。
名稱 | 類型 | Description |
---|---|---|
error |
Api 錯誤。 |
InnerError
內部錯誤詳細數據。
名稱 | 類型 | Description |
---|---|---|
errordetail |
string |
內部錯誤訊息或例外狀況傾印。 |
exceptiontype |
string |
例外狀況類型。 |
OSProfileProvisioningData
重新製作非暫時虛擬機映像的其他參數。
名稱 | 類型 | Description |
---|---|---|
adminPassword |
string |
指定系統管理員帳戶的密碼。 |
customData |
string |
指定自訂數據的base-64編碼字串。 base-64 編碼字串會譯碼為儲存為虛擬機上檔案的二進位數組。 二進位陣列的最大長度為65535個字節。 注意:請勿在 customData 屬性中傳遞任何秘密或密碼。 建立 VM 之後,就無法更新此屬性。 屬性 customData 會傳遞至要儲存為檔案的 VM,如需詳細資訊,請參閱 Azure VM 上的自定義數據。 如果針對 Linux VM 使用 cloud-init,請參閱 在建立期間使用 cloud-init 自定義 Linux VM。 |
VirtualMachineScaleSetReimageParameters
描述虛擬機擴展集 VM 重新映像參數。
名稱 | 類型 | Description |
---|---|---|
exactVersion |
string |
以十進位數指定作業系統磁碟應重新映像至的版本。 如果未提供確切版本,OS 磁碟會重新映像到現有的 OS 磁碟版本。 |
forceUpdateOSDiskForEphemeral |
boolean |
強制更新虛擬機擴展集 VM 暫時 OS 磁碟的參數 |
instanceIds |
string[] |
虛擬機擴展集實例標識碼。 省略虛擬機擴展集實例標識碼會導致作業在虛擬機擴展集的所有虛擬機上執行。 |
osProfile |
指定重新映像非暫時 OS 磁碟所需的資訊。 |
|
tempDisk |
boolean |
指定是否要重新設定暫存磁碟的映像。 默認值:false。 注意:只有具有暫時 OS 磁碟的 VM/VMSS 才支援此暫存磁碟重新映像參數。 |