Virtual Machine Scale Sets - Get OS Upgrade History

參考

服務:: Compute

API 版本:: 2019-03-01

取得 VM 擴展集實例上的 OS 升級清單。

HTTP

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/osUpgradeHistory?api-version=2019-03-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
200 OK	VirtualMachineScaleSetListOSUpgradeHistory	確定

安全性

azure_auth

Azure Active Directory OAuth2 Flow

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

範圍

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

定義

名稱	Description
ApiError	API 錯誤。
ApiErrorBase	API 錯誤基底。
ImageReference	指定要使用之映像的相關信息。您可以指定平臺映像、Marketplace 映像或虛擬機映射的相關信息。當您想要使用平臺映像、市集映像或虛擬機映像，但不會用於其他建立作業時，需要此元素。注意：映像參考發行者和供應專案只能在您建立擴展集時設定。
InnerError	內部錯誤詳細數據。
RollbackStatusInfo	在OS升級作業之後復原失敗 VM 實例的相關信息。
RollingUpgradeProgressInfo	每個升級狀態中虛擬機實例數目的相關信息。
UpgradeOperationHistoricalStatusInfo	虛擬機擴展集OS升級歷程記錄作業回應。
UpgradeOperationHistoricalStatusInfoProperties	描述虛擬機擴展集上的每個OS升級。
UpgradeOperationHistoryStatus	整體升級目前執行狀態的相關信息。
UpgradeOperationInvoker	升級作業的叫用者
UpgradeState	指出升級目前狀態的程序代碼。
VirtualMachineScaleSetListOSUpgradeHistory	虛擬機擴展集OS升級歷程記錄作業回應的清單。

ApiError

API 錯誤。

名稱	類型	Description
code	string	錯誤碼。
details	ApiErrorBase[]	API 錯誤詳細數據
innererror	InnerError	Api 內部錯誤
message	string	錯誤訊息。
target	string	特定錯誤的目標。

ApiErrorBase

API 錯誤基底。

名稱	類型	Description
code	string	錯誤碼。
message	string	錯誤訊息。
target	string	特定錯誤的目標。

ImageReference

指定要使用之映像的相關信息。您可以指定平臺映像、Marketplace 映像或虛擬機映射的相關信息。當您想要使用平臺映像、市集映像或虛擬機映像，但不會用於其他建立作業時，需要此元素。注意：映像參考發行者和供應專案只能在您建立擴展集時設定。

名稱	類型	Description
id	string	資源標識碼
offer	string	指定用來建立虛擬機的平臺映像或市集映像供應專案。
publisher	string	映像發行者。
sku	string	映像 SKU。
version	string	指定用來建立虛擬機的平臺映像或 Marketplace 映像版本。允許的格式為 Major.Minor.Build 或 'latest'。主要、次要和組建都是十進位數。指定「最新」以使用部署階段可用的最新映像版本。即使您使用「最新」，即使有新版本可供使用，VM 映像也不會在部署時間之後自動更新。

InnerError

內部錯誤詳細數據。

名稱	類型	Description
errordetail	string	內部錯誤訊息或例外狀況傾印。
exceptiontype	string	例外狀況型別。

RollbackStatusInfo

在OS升級作業之後復原失敗 VM 實例的相關信息。

名稱	類型	Description
failedRolledbackInstanceCount	integer	無法復原的實例數目。
rollbackError	ApiError	如果 OS 復原失敗，錯誤詳細數據。
successfullyRolledbackInstanceCount	integer	已成功復原的實例數目。

RollingUpgradeProgressInfo

每個升級狀態中虛擬機實例數目的相關信息。

名稱	類型	Description
failedInstanceCount	integer	無法成功升級的實例數目。
inProgressInstanceCount	integer	目前正在升級的實例數目。
pendingInstanceCount	integer	尚未開始升級的實例數目。
successfulInstanceCount	integer	已成功升級的實例數目。

UpgradeOperationHistoricalStatusInfo

虛擬機擴展集OS升級歷程記錄作業回應。

名稱	類型	Description
location	string	資源位置
properties	UpgradeOperationHistoricalStatusInfoProperties	升級作業屬性的相關信息。
type	string	資源類型

UpgradeOperationHistoricalStatusInfoProperties

描述虛擬機擴展集上的每個OS升級。

名稱	類型	Description
error	ApiError	如果有的話，此升級的錯誤詳細數據。
progress	RollingUpgradeProgressInfo	每個狀態中的 VM 計數。
rollbackInfo	RollbackStatusInfo	執行時OS復原的相關信息
runningStatus	UpgradeOperationHistoryStatus	升級作業整體狀態的相關信息。
startedBy	UpgradeOperationInvoker	升級作業的叫用者
targetImageReference	ImageReference	影像參考詳細數據

UpgradeOperationHistoryStatus

整體升級目前執行狀態的相關信息。

名稱	類型	Description
code	UpgradeState	指出升級目前狀態的程序代碼。
endTime	string	升級的結束時間。
startTime	string	升級的開始時間。

UpgradeOperationInvoker

升級作業的叫用者

名稱	類型	Description
Platform	string
Unknown	string
User	string

UpgradeState

指出升級目前狀態的程序代碼。

名稱	類型	Description
Cancelled	string
Completed	string
Faulted	string
RollingForward	string

VirtualMachineScaleSetListOSUpgradeHistory

虛擬機擴展集OS升級歷程記錄作業回應的清單。

名稱	類型	Description
nextLink	string	要擷取作業系統升級歷程記錄下一頁的URI。使用此呼叫 ListNext () 以擷取升級的下一頁歷程記錄。
value	UpgradeOperationHistoricalStatusInfo[]	虛擬機擴展集上執行的OS升級清單。

共用方式為