Aktualisieren von Domänen durchlaufen

Artikel
07/19/2023

Durch den asynchronen Vorgang Walk Upgrade Domain wird eine Updatedomäne angegeben, in der eine Rolleninstanz aktualisiert werden muss.

Anforderung

Die Walk Upgrade Domain-Anforderung kann wie folgt angegeben werden. ersetzen Sie <subscription-id> durch die Abonnement-ID, <cloudservice-name> durch den Namen des Clouddiensts, <deployment-slot> durch staging oder productionund <deployment-name> durch den Namen der Bereitstellung.

Methode	Anforderungs-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-Parameter

URI-Parameter	BESCHREIBUNG
`comp=walkupgradedomain`	Erforderlich. Gibt an, dass bei der Aktualisierung der Rolleninstanzen in einer Bereitstellung während einem manuellen direkten Update die Updatedomänen einzeln nacheinander aktualisiert werden.

Anforderungsheader

In der folgenden Tabelle werden die Anforderungsheader beschrieben.

Anforderungsheader	BESCHREIBUNG
`Content-Type`	Erforderlich. Legen Sie diesen Header auf `application/xml` fest.
`x-ms-version`	Erforderlich. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Dieser Header sollte auf `2009-10-01` oder höher festgelegt werden.

Anforderungstext

Der Anforderungstext weist das folgende Format auf:

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

In der folgenden Tabelle werden die Elemente im Anforderungstext beschrieben.

Elementname	BESCHREIBUNG
UpgradeDomain	Erforderlich. Gibt einen ganzzahligen Wert an, der die zu aktualisierende Updatedomäne identifiziert. Updatedomänen werden anhand eines nullbasierten Index identifiziert: die erste Updatedomäne hat eine ID von 0, die zweite eine ID von 1 usw.

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Statuscode

Bei einem erfolgreichen Vorgang wird der Statuscode 200 (OK) zurückgegeben.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten.

Antwortheader	BESCHREIBUNG
`x-ms-request-id`	Ein Wert, der eine für den Verwaltungsdienst ausgeführte Anforderung eindeutig identifiziert. Bei einem asynchronen Vorgang können Sie Den Vorgangsstatus abrufen mit dem Wert des Headers aufrufen, um zu bestimmen, ob der Vorgang abgeschlossen ist, ein Fehler aufgetreten ist oder noch ausgeführt wird.

Antworttext

Keine.

Hinweise

Vor dem Aufrufen des Walk Upgrade Domain Vorgangs müssen Sie Upgrade Deployment, Change Deployment Configuration oder Rollback Update or Upgrade (Update oder Upgrade) aufgerufen haben.

Standardmäßig wird ein Dienst mit fünf Updatedomänen bereitgestellt, die während eines direkten Updates einzeln nacheinander aktualisiert werden.

Um ein manuelles Update einer Bereitstellung auszuführen, gehen Sie in dieser Reihenfolge vor:

Rufen Sie Die Upgradebereitstellung auf, wobei das Mode Element auf manualfestgelegt ist.
Rufen Sie Walk Upgrade Domain auf, um die einzelnen Domänen innerhalb der Bereitstellung zu aktualisieren. Updatedomänen müssen der Reihenfolge nach aktualisiert werden. Starten Sie beispielsweise mit Domäne 0, fahren Sie mit Domäne 1 fort usw.

Ein Update, durch das Rolleninstanzen hinzugefügt oder entfernt werden, führt zu einem Konfigurationsupdate aller Rollen, die im Cloud-Dienst bereitgestellt sind. Vorhandene Rolleninstanzen müssen über neue Rolleninstanzen benachrichtigt werden, damit alle Rolleninstanzen im Cloud-Dienst miteinander kommunizieren können.

Rufen Sie während eines Updates Bereitstellung abrufen auf, um die status zu ermitteln. Wenn das Update ausgeführt wird, gibt Get Deployment ein UpgradeStatus-Element zurück, das Informationen zum Update enthält. Wenn das Update abgeschlossen ist oder wenn kein Update ausgeführt wird, dann ist das UpgradeStatus-Element Null.

Freigeben über