Gå igenom uppgraderingsdomän

Artikel
07/19/2023

Den Walk Upgrade Domain asynkrona åtgärden anger en uppdateringsdomän där en rollinstans måste uppdateras.

Förfrågan

Begäran Walk Upgrade Domain kan anges på följande sätt. ersätt <subscription-id> med prenumerations-ID:t med <cloudservice-name> namnet på molntjänsten, <deployment-slot> med staging eller production, och <deployment-name> med namnet på distributionen.

Metod	URI för förfrågan
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-parametrar

URI-parameter	Description
`comp=walkupgradedomain`	Krävs. Anger att rollinstanserna i en distribution uppdateras en uppdateringsdomän i taget under en manuell uppdatering på plats.

Rubriker för begäran

I följande tabell beskrivs begäranderubrikerna.

Begärandehuvud	Description
`Content-Type`	Krävs. Ställ in det här huvudet på `application/xml`.
`x-ms-version`	Krävs. Anger vilken version av åtgärden som ska användas för den här begäran. Det här huvudet ska vara inställt på `2009-10-01` eller högre.

Begärandetext

Formatet för begärandetexten är följande:

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

I följande tabell beskrivs elementen i begärandetexten.

Elementnamn	Beskrivning
UpgradeDomain	Krävs. Anger ett heltalsvärde som identifierar uppdateringsdomänen som ska uppdateras. Uppdateringsdomäner identifieras med ett nollbaserat index: den första uppdateringsdomänen har ett ID på 0, den andra har ett ID på 1 och så vidare.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Statuskod

En lyckad åtgärd returnerar statuskoden 200 (OK).

Svarsrubriker

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden.

Svarshuvud	Description
`x-ms-request-id`	Ett värde som unikt identifierar en begäran som görs mot hanteringstjänsten. För en asynkron åtgärd kan du anropa Hämta åtgärdsstatus med värdet för huvudet för att avgöra om åtgärden är slutförd, har misslyckats eller fortfarande pågår.

Svarstext

Inga.

Kommentarer

Innan du anropar Walk Upgrade Domain åtgärden måste du ha anropat Uppgraderingsdistribution, Ändra distributionskonfiguration eller Återställningsuppdatering eller uppgradering.

Som standard distribueras en tjänst med fem uppdateringsdomäner, som uppdateras en i taget under en uppdatering på plats.

Om du vill utföra en manuell uppdatering av en distribution fortsätter du i följande ordning:

Anropa Uppgraderingsdistribution med elementet Mode inställt på manual.
Anropa Walk Upgrade Domain för att uppdatera varje domän i distributionen. Uppdateringsdomäner måste uppdateras i ordning. Börja till exempel med domän 0, fortsätt till domän 1 och så vidare.

En uppdatering som lägger till eller tar bort rollinstanser resulterar i en konfigurationsuppdatering för alla roller som distribueras i molntjänsten. Befintliga rollinstanser måste meddelas om nya rollinstanser så att alla rollinstanser kan kommunicera tillsammans i molntjänsten.

När en uppdatering pågår anropar du Hämta distribution för att fastställa dess status. Om uppdateringen pågår Get Deployment returnerar ett UpgradeStatus element som innehåller information om uppdateringen. Om uppdateringen är klar eller om ingen uppdatering pågår är elementet UpgradeStatus null.

Dela via