共用方式為


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
resourceGroupName
path True

string

資源群組的名稱。

subscriptionId
path True

string

可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。

vmScaleSetName
path True

string

VM 擴展集的名稱。

api-version
query True

string

用戶端 API 版本。

要求本文

名稱 類型 Description
exactVersion

string

以十進位數指定作業系統磁碟應重新映像至的版本。 如果未提供確切版本,OS 磁碟會重新映像到現有的 OS 磁碟版本。

forceUpdateOSDiskForEphemeral

boolean

強制更新虛擬機擴展集 VM 暫時 OS 磁碟的參數

instanceIds

string[]

虛擬機擴展集實例標識碼。 省略虛擬機擴展集實例標識碼會導致作業在虛擬機擴展集的所有虛擬機上執行。

osProfile

OSProfileProvisioningData

指定重新映像非暫時 OS 磁碟所需的資訊。

tempDisk

boolean

指定是否要重新設定暫存磁碟的映像。 默認值:false。 注意:只有具有暫時 OS 磁碟的 VM/VMSS 才支援此暫存磁碟重新映像參數。

回應

名稱 類型 Description
200 OK

還行

202 Accepted

接受

Other Status Codes

CloudError

描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

VirtualMachineScaleSet_Reimage_MaximumSet_Gen
VirtualMachineScaleSet_Reimage_MinimumSet_Gen

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

範例要求

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-07-01

範例回覆

location: https://foo.com/operationstatus

定義

名稱 Description
ApiError

Api 錯誤。

ApiErrorBase

API 錯誤基底。

CloudError

來自計算服務的錯誤回應。

InnerError

內部錯誤詳細數據。

OSProfileProvisioningData

重新製作非暫時虛擬機映像的其他參數。

VirtualMachineScaleSetReimageParameters

描述虛擬機擴展集 VM 重新映像參數。

ApiError

Api 錯誤。

名稱 類型 Description
code

string

錯誤碼。

details

ApiErrorBase[]

Api 錯誤詳細數據

innererror

InnerError

Api 內部錯誤

message

string

錯誤訊息。

target

string

特定錯誤的目標。

ApiErrorBase

API 錯誤基底。

名稱 類型 Description
code

string

錯誤碼。

message

string

錯誤訊息。

target

string

特定錯誤的目標。

CloudError

來自計算服務的錯誤回應。

名稱 類型 Description
error

ApiError

Api 錯誤。

InnerError

內部錯誤詳細數據。

名稱 類型 Description
errordetail

string

內部錯誤訊息或例外狀況傾印。

exceptiontype

string

例外狀況類型。

OSProfileProvisioningData

重新製作非暫時虛擬機映像的其他參數。

名稱 類型 Description
adminPassword

string

指定系統管理員帳戶的密碼。

最小長度 (Windows): 8 個字元

最小長度 (Linux): 6 個字元

長度上限 (Windows): 123 個字元

長度上限(Linux): 72 個字元

複雜性需求:需要滿足下列 4 個條件中的 3 個
字元較低
具有大字元
具有數位
具有特殊字元 (Regex match [\W_])

不允許的值: “abc@123”、“P@$$w 0rd”、“P@ssw0rd”、“P@ssword123”、“Pa$$word”、“pass@word1”、“Password!”、“Password1”、“Password22”、“iloveyou!”

如需重設密碼,請參閱 如何在 Windows VM 中重設遠端桌面服務或其登入密碼

如需重設根密碼,請參閱 使用 VMAccess 擴充功能 管理使用者、SSH 及檢查或修復 Azure Linux VM 上的磁碟

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

OSProfileProvisioningData

指定重新映像非暫時 OS 磁碟所需的資訊。

tempDisk

boolean

指定是否要重新設定暫存磁碟的映像。 默認值:false。 注意:只有具有暫時 OS 磁碟的 VM/VMSS 才支援此暫存磁碟重新映像參數。