Updates - List Parent

服務:

Maintenance

API 版本:

2023-09-01-preview

取得資源的更新。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceParentType}/{resourceParentName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/updates?api-version=2023-09-01-preview

URI 參數

名稱	位於	必要	類型	Description
providerName	path	True	string	資源提供者名稱
resourceGroupName	path	True	string	資源組名
resourceName	path	True	string	資源標識碼
resourceParentName	path	True	string	資源父標識碼
resourceParentType	path	True	string	資源父類型
resourceType	path	True	string	資源類型
subscriptionId	path	True	string	可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。
api-version	query	True	string	要與用戶端要求搭配使用的 API 版本。

回應

名稱	類型	Description
200 OK	ListUpdatesResult	還行
Other Status Codes	MaintenanceError	錯誤的請求

範例

Updates_ListParent

範例要求

HTTP

GET https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1/virtualMachines/1/providers/Microsoft.Maintenance/updates?api-version=2023-09-01-preview

範例回覆

狀態碼:

200

{
  "value": [
    {
      "maintenanceScope": "Resource",
      "status": "Pending",
      "impactType": "Reboot",
      "impactDurationInSec": 1440,
      "notBefore": "2018-10-09T06:17:44.235Z",
      "properties": {
        "resourceId": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1/virtualMachines/1"
      }
    }
  ]
}

定義

名稱	Description
ErrorDetails	從 Azure 維護服務收到的錯誤回應詳細數據。
ImpactType	影響類型
ListUpdatesResult	更新的回應清單
MaintenanceError	從 Azure 維護服務收到的錯誤回應。
MaintenanceScope	取得或設定組態的 maintenanceScope
Update	資源上的維護更新
UpdateStatus	狀態

ErrorDetails

Object

從 Azure 維護服務收到的錯誤回應詳細數據。

名稱	類型	Description
code	string	服務定義的錯誤碼。 此程式代碼可作為回應中所指定 HTTP 錯誤碼的子狀態。
message	string	人類可讀取的錯誤表示法。

ImpactType

列舉型別

影響類型

值	Description
None	擱置的更新不會影響資源。
Freeze	擱置的更新可能會凍結資源上的網路或磁碟io作業。
Restart	擱置的更新可能會導致資源重新啟動。
Redeploy	擱置的更新可以重新部署資源。

ListUpdatesResult

Object

更新的回應清單

名稱	類型	Description
value	Update[]	擱置的更新

MaintenanceError

Object

從 Azure 維護服務收到的錯誤回應。

名稱	類型	Description
error	ErrorDetails	錯誤的詳細數據

MaintenanceScope

列舉型別

取得或設定組態的 maintenanceScope

值	Description
Host	此維護範圍可控制 Azure 平臺更新的安裝，也就是裝載客戶 VM 之實體節點上的服務。
Resource	此維護範圍會控制 Azure 資源的預設更新維護
OSImage	此維護範圍可控制 VM/VMSS 上的 OS 映像安裝
Extension	此維護範圍可控制 VM/VMSS 上的擴充功能安裝
InGuestPatch	此維護範圍可控制 VM/VMSS 上 Windows 和 Linux 套件的安裝
SQLDB	此維護範圍可控制 SQL Server 平臺更新的安裝。
SQLManagedInstance	此維護範圍可控制 SQL 受控實例平臺更新的安裝。

Update

Object

資源上的維護更新

名稱	類型	Description
impactDurationInSec	integer (int32)	影響持續時間以秒為單位
impactType	ImpactType	影響類型
maintenanceScope	MaintenanceScope	影響區域
notBefore	string (date-time)	如果客戶在此時間之前未自行更新，Azure 將會開始強制更新的時間
properties.resourceId	string	resourceId
status	UpdateStatus	狀態

UpdateStatus

列舉型別

狀態

值	Description
Pending	有擱置的更新要安裝。
InProgress	更新安裝正在進行中。
Completed	已成功套用所有更新。
RetryNow	更新安裝失敗，但已準備好再次重試。
RetryLater	更新安裝失敗，稍後應重試。
NoUpdatesPending	沒有任何更新擱置中。
Cancel	取消排程，並停止為其一部分的資源建立 PMR。 僅適用於維護設定資源類型。
Cancelled	如果要求來取消排程，請將 Canceled 回應傳送給使用者。 僅適用於維護設定資源類型。