逐步升級網域

發行項
08/05/2023

Walk Upgrade Domain 非同步作業會指定必須更新角色執行個體的更新網域。

要求

請使用下列格式指定 Walk Upgrade Domain 要求。以 <subscription-id> 訂用帳戶識別碼取代為雲端服務的名稱、 <cloudservice-name><deployment-slot> 或 stagingproduction ，並以 <deployment-name> 部署的名稱取代。

方法	要求 URI
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/?comp=walkupgradedomain`
POST	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/?comp=walkupgradedomain`

URI 參數

URI 參數	描述
`comp=walkupgradedomain`	必要。指定在手動就地更新期間，更新部署中的角色執行個體 (一次一個更新網域)。

要求標頭

下表描述要求標頭。

要求標頭	描述
`Content-Type`	必要。將此標頭設定為 `application/xml`。
`x-ms-version`	必要。指定用於這個要求的作業版本。此標頭應設定為 `2009-10-01` 或更新版本。

要求本文

要求主體的格式如下：

  
<?xml version="1.0" encoding="utf-8"?>  
<WalkUpgradeDomain xmlns="http://schemas.microsoft.com/windowsazure">  
  <UpgradeDomain>update-domain-id</UpgradeDomain>  
</WalkUpgradeDomain>

下表說明要求主體的元素。

元素名稱	Description
UpgradeDomain	必要。指定可識別要更新之更新網域的整數值。更新網域會使用以零為基底的索引加以識別：第一個更新網域的 ID 為 0，第二個更新網域的 ID 為 1，依此類推。

回應

回應包括 HTTP 狀態碼和一組回應標頭。

狀態碼

成功的作業會傳回狀態碼 200 (OK)。

回應標頭

這項作業的回應包括下列標頭。回應也可能包括其他標準 HTTP 標頭。

回應標頭	Description
`x-ms-request-id`	唯一識別對管理服務發出之要求的值。針對非同步作業，您可以使用標頭的值呼叫取得作業狀態，以判斷作業是否已完成、失敗或仍在進行中。

回應本文

無。

備註

在呼叫 Walk Upgrade Domain 作業之前，您必須呼叫升級部署、變更部署組態或復原更新或升級。

根據預設，服務會使用五個更新網域來部署，而且在就地更新期間，一次更新一個更新網域。

若要執行部署的手動更新，請依照下列順序進行：

呼叫升級部署，並將 Mode 專案設定為 manual 。
呼叫 Walk Upgrade Domain 以更新部署內的每個網域。更新網域必須依序更新。例如，從網域 0 開始、繼續更新網域 1，依此類推。

加入或移除角色執行個體的更新將會導致系統對雲端服務中部署的所有角色進行組態更新。現有的角色執行個體必須收到新角色執行個體的通知，如此所有角色執行個體才能在雲端服務中相互通訊。

進行更新時，請呼叫取得部署來判斷其狀態。如果更新正在進行中，Get Deployment 就會傳回包含更新相關資訊的 UpgradeStatus 元素。如果更新已完成，或者沒有任何更新正在進行中，則 UpgradeStatus 元素就是 null。

共用方式為