Passare al dominio di aggiornamento

Articolo
07/19/2023

L'operazione asincrona Walk Upgrade Domain specifica un dominio di aggiornamento in cui deve essere aggiornata un'istanza del ruolo.

Richiesta

La richiesta di Walk Upgrade Domain può essere specificata come indicato di seguito. sostituire <subscription-id> con l'ID sottoscrizione, <cloudservice-name> con il nome del servizio cloud, <deployment-slot> con staging o productione <deployment-name> con il nome della distribuzione.

Metodo	URI richiesta
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`

Parametri dell'URI

Parametro URI	Descrizione
`comp=walkupgradedomain`	Obbligatorio. Specifica che le istanze del ruolo in una distribuzione vengono aggiornate un dominio di aggiornamento alla volta durante l'aggiornamento manuale sul posto.

Intestazioni richiesta

La tabella seguente descrive le intestazioni della richiesta.

Intestazione della richiesta	Descrizione
`Content-Type`	Obbligatorio. Impostare questa intestazione su `application/xml`.
`x-ms-version`	Obbligatorio. Specifica la versione dell'operazione da usare per questa richiesta. Questa intestazione deve essere impostata su `2009-10-01` o superiore.

Corpo della richiesta

Il formato del corpo della richiesta è il seguente:

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

Nella tabella indicata di seguito vengono descritti gli elementi nel corpo della richiesta.

Nome dell'elemento	Descrizione
UpgradeDomain	Obbligatorio. Specifica un valore intero che identifica il dominio di aggiornamento da aggiornare. I domini di aggiornamento vengono identificati con un indice in base zero: l'ID del primo dominio di aggiornamento è 0, l'ID del secondo dominio di aggiornamento è 1 e così via.

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codice di stato

Un'operazione completata correttamente restituisce 200 (OK).

Intestazioni della risposta

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive.

Intestazione di risposta	Descrizione
`x-ms-request-id`	Valore che identifica in modo univoco una richiesta eseguita nel servizio di gestione. Per un'operazione asincrona, è possibile chiamare Recupera stato operazione con il valore dell'intestazione per determinare se l'operazione è stata completata, ha avuto esito negativo o è ancora in corso.

Corpo della risposta

No.

Osservazioni

Prima di chiamare l'operazioneWalk Upgrade Domain, è necessario chiamare Distribuzione di aggiornamento, Modifica configurazione distribuzione o Aggiornamento rollback.

Per impostazione predefinita, un servizio viene distribuito con cinque domini di aggiornamento, che vengono aggiornati uno alla volta durante l'aggiornamento sul posto.

Per eseguire un aggiornamento manuale di una distribuzione, procedere nell'ordine indicato:

Chiamare La distribuzione dell'aggiornamento con l'elemento Mode impostato su manual.
Chiamare Walk Upgrade Domain per aggiornare ogni dominio nella distribuzione. I domini di aggiornamento devono essere aggiornati in ordine. Ad esempio, iniziare con il dominio 0, procedere con il dominio 1 e così via.

Un aggiornamento che aggiunge o rimuove le istanze del ruolo comporterà un aggiornamento della configurazione in tutti i ruoli che vengono distribuiti nel servizio cloud. Le istanze del ruolo esistenti devono essere a conoscenza delle nuove istanze del ruolo per consentire la comunicazione tra tutte le istanze nel servizio cloud.

Mentre un aggiornamento è in corso, chiamare Recupera distribuzione per determinare il relativo stato. Se l'aggiornamento è in corso, Get Deployment restituisce un elemento UpgradeStatus che contiene informazioni sull'aggiornamento. Se l'aggiornamento è completato o se non è in corso alcun aggiornamento, l'elemento UpgradeStatus è Null.

Condividi tramite