Esporta (0) Stampa
Espandi tutto

Passare al dominio di aggiornamento

Aggiornamento: aprile 2014

L'operazione Walk Upgrade Domain specifica un dominio di aggiornamento in cui deve essere aggiornata un'istanza del ruolo. Per ulteriori informazioni sull'aggiornamento delle istanze del ruolo, vedere Aggiornare un servizio di Windows Azure.

L'operazione Walk Upgrade Domain è un'operazione asincrona. Per determinare se il servizio di gestione ha terminato l'elaborazione della richiesta, chiamare Ottenere lo stato delle operazioni. Per ulteriori informazioni sulle operazioni asincrone, vedere Rilevamento delle richieste asincrone di gestione del servizio.

La richiesta di Walk Upgrade Domain può essere specificata come indicato di seguito. È possibile aggiornare i domini specificando l'ambiente di distribuzione (gestione temporanea o produzione) oppure specificando il nome univoco della distribuzione.

Per generare l'URI della richiesta, sostituire <subscription-id> con l'ID sottoscrizione, <cloudservice-name> con il nome del servizio cloud, <deployment-slot> con staging o production e <deployment-name> con il nome univoco della distribuzione.

 

Metodo URI della richiesta Versione HTTP

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/?comp=walkupgradedomain

HTTP/1.1

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/?comp=walkupgradedomain

HTTP/1.1

 

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.

Nella tabella seguente vengono descritte le intestazioni delle richieste.

 

Intestazione della richiesta Descrizione

Content-Type

Obbligatoria. Impostare questa intestazione su application/xml.

x-ms-version

Obbligatoria. Specifica la versione dell'operazione da utilizzare per questa richiesta. Questa intestazione deve essere impostata su 2009-10-01 o una versione successiva. Per ulteriori informazioni sulle intestazioni di controllo delle versioni, vedere Controllo delle versioni di gestione del servizio.

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 seguente vengono descritti gli elementi chiave nel corpo della richiesta:

 

Nome elemento Descrizione

UpgradeDomain

Obbligatorio. 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.

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

Poiché Walk Upgrade Domain è un'operazione asincrona, è necessario chiamare Ottenere lo stato delle operazioni per determinare se l'operazione è completata, non riuscita o in corso. Se si esegue l'aggiornamento di più domini, è necessario chiamare Get Operation Status per verificare che l'aggiornamento sia completo prima di aggiornare il dominio successivo.

Poiché Walk Upgrade Domain è un'operazione asincrona, restituisce sempre il codice di stato 202 (Accettato). Per determinare il codice di stato per l'operazione dopo che è stata completata, chiamare Ottenere lo stato delle operazioni. Il codice di stato è incorporato nella risposta per questa operazione; se ha esito positivo, sarà 200 (OK). Per informazioni sui codici di stato, vedere Codici di stato e di errore relativi alla gestione dei servizi.

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

 

Intestazione della risposta Descrizione

x-ms-request-id

Valore che identifica in modo univoco una richiesta effettuata nel servizio di gestione. Per un'operazione asincrona, è possibile chiamare lo stato di operazione get con il valore dell'intestazione per determinare se l'operazione è completata, non riuscita o in corso. Per ulteriori informazioni, vedere Rilevamento delle richieste asincrone di gestione del servizio.

Per eseguire l'autenticazione di questa operazione, è possibile utilizzare un qualsiasi certificato di gestione associato alla sottoscrizione specificata da <subscription-id>. Per ulteriori dettagli, vedere Autenticazione di richieste di gestione dei servizi.

Prima di chiamare l'operazione Walk Upgrade Domain è necessario chiamare Aggiornare la distribuzione, Modificare la configurazione di distribuzione o Aggiornamento o aggiornamento di 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 informazioni sulla modifica del numero di domini di aggiornamento nel file di definizione del servizio, vedere Schema di definizione dei servizi di Windows Azure (file .csdef).

Per eseguire un aggiornamento manuale della distribuzione, procedere nell'ordine seguente:

  1. Chiamare Aggiornare la distribuzione con l'elemento Mode impostato su manual.

  2. 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.

ImportantImportante
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.

Durante un aggiornamento in corso, chiamare Ottenere la distribuzione per determinarne lo 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.

Mostra:
© 2014 Microsoft