Aggiornare la distribuzione

L'operazione asincrona Upgrade Deployment avvia un aggiornamento di istanze del ruolo in una distribuzione usando il pacchetto e la configurazione specificati.

Richiesta

La richiesta di Upgrade Deployment 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 production e <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>/
POST	https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/

Parametri dell'URI

Parametro URI	Descrizione
comp=upgrade	Obbligatorio. Specifica che la distribuzione deve essere aggiornata.

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 versione successiva.

Corpo della richiesta

Il formato del corpo della richiesta è il seguente:

  
<?xml version="1.0" encoding="utf-8"?>  
<UpgradeDeployment xmlns="http://schemas.microsoft.com/windowsazure">  
  <Mode>type-of-upgrade</Mode>  
  <PackageUrl>url-to-package</PackageUrl>  
  <Configuration>base64-encoded-config-file</Configuration>  
  <Label>base-64-encoded-label</Label>  
  <RoleToUpgrade>role-name</RoleToUpgrade>  
  <Force>true|false</Force>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>property-name</Name>  
      <Value>property-value</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>  
  <ExtensionConfiguration>  
    <AllRoles>  
      <Extension>  
        <Id>identifier-of-extension</Id>  
        <State>state-of-extension</State>  
      </Extension>  
    </AllRoles>  
    <NamedRoles>  
      <Role>  
        <RoleName>role_name1</RoleName>  
        <Extensions>  
          <Extension>  
            <Id>identifier-of-extension</Id>  
            <State>state-of-extension</State>  
          </Extension>  
        </Extensions>  
      </Role>  
    </NamedRoles>  
  </ExtensionConfiguration>  
</UpgradeDeployment>  
  

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

Nome dell'elemento	Descrizione
Mode	Obbligatorio. Specifica il tipo di aggiornamento da avviare. Le istanze del ruolo vengono allocate a domini di aggiornamento quando il servizio viene distribuito. Gli aggiornamenti possono essere avviati manualmente in ogni dominio di aggiornamento o avviati automaticamente in tutti i domini di aggiornamento. I valori possibili sono: - Auto - Manual - Simultaneous Se non è specificato, il valore predefinito è Auto. Se impostato su Manual, WalkUpgradeDomain deve essere chiamato per applicare l'aggiornamento. Se è impostato su Auto, l'aggiornamento viene applicato automaticamente a ogni dominio di aggiornamento in sequenza. L'impostazione Simultaneous è disponibile solo nella versione 2012-12-01 o versioni successive.
PackageUrl	Obbligatorio. Specifica un URL che fa riferimento alla posizione del pacchetto del servizio nel servizio BLOB. Il pacchetto del servizio può trovarsi in un account di archiviazione nella stessa sottoscrizione o un URI della firma di accesso condiviso da qualsiasi account di archiviazione. Per altre informazioni sulle firme di accesso condiviso, vedere Delega dell'accesso con una firma di accesso condiviso.
Configurazione	Obbligatorio. Specifica il file di configurazione del servizio con codifica Base 64 per la distribuzione.
Etichetta	Obbligatorio. Specifica il nome per il servizio cloud con codifica Base 64. Il nome può contenere un massimo di 100 caratteri. È consigliabile usare un'etichetta univoca all'interno della sottoscrizione. Il nome può essere usato per identificare il servizio cloud per motivi di rilevamento.
RoleToUpgrade	Facoltativa. Specifica il nome dell'istanza del ruolo specifica da aggiornare. Nell'aggiornamento a ruolo singolo tutti gli altri ruoli possono comunque riciclarsi se è previsto un aggiornamento interno di Azure. Il dominio di aggiornamento è garantito in questo scenario.
Force	Obbligatorio. Indica se l'aggiornamento deve continuare anche quando i dati locali andranno persi da alcune istanze del ruolo. True se l'aggiornamento deve continuare; in caso contrario false, . L'elemento Force è disponibile solo se si utilizza la versione 01.10.11 o una versione successiva.
Nome	Facoltativa. Specifica il nome di una proprietà estesa del servizio cloud. Ogni proprietà estesa deve contenere un nome e un valore definiti. È possibile avere un massimo di 25 coppie nome/valore per le proprietà estese. La lunghezza massima dell'elemento Name è di 64 caratteri. Nel nome sono validi solo i caratteri alfanumerici e i caratteri di sottolineatura. Il nome deve iniziare con una lettera. Se si tenta di usare altri caratteri, di immettere un elemento che inizia con un carattere diverso da una lettera o di specificare un nome identico a quello di un'altra proprietà estesa appartenente allo stesso servizio cloud, si verificherà un errore con codice di stato 400 (Richiesta non valida). L'elemento Name è disponibile solo con la versione 2012-03-01 o successiva.
Valore	Facoltativa. Specifica il valore di una proprietà estesa del servizio cloud. Ogni proprietà estesa deve contenere un nome e un valore definiti. È possibile avere un massimo di 25 coppie nome/valore per le proprietà estese e il valore di ciascuna proprietà contiene un massimo di 255 caratteri. Eliminare una proprietà estesa impostando il valore su NULL. L'elemento Value è disponibile solo con la versione 2012-03-01 o successiva.
ExtensionConfiguration	Facoltativa. Specifica un'estensione aggiunta al servizio cloud. In Azure un processo può essere eseguito come estensione di un servizio cloud. È necessario aggiungere un'estensione al servizio cloud usando Aggiungi estensione prima di poter essere aggiunta alla distribuzione durante un aggiornamento. L'elemento ExtensionConfiguration è disponibile solo se si utilizza la versione 01.03.13 o una versione successiva.

ExtensionConfiguration

Specifica un'estensione aggiunta al servizio cloud.

Nome dell'elemento	Descrizione
AllRoles	Facoltativa. Specifica un elenco di estensioni applicate a tutti i ruoli in una distribuzione.
Estensione	Obbligatorio. Specifica un'estensione che deve essere distribuita in un ruolo in un servizio cloud.
NamedRoles	Facoltativa. Specifica un elenco di estensioni applicate a ruoli specifici in una distribuzione.

Estensione

Specifica un'estensione che deve essere distribuita in un ruolo in un servizio cloud.

Nome dell'elemento	Descrizione
ID	Obbligatorio. Specifica l'identificatore dell'estensione. L'identificatore viene creato quando l'estensione viene aggiunta al servizio cloud. È possibile trovare l'ID di un'estensione aggiunta a un servizio cloud usando Le estensioni elenco.
State	Facoltativa. Specifica lo stato dell'estensione. Questo elemento si applica a estensioni configurate JSON. I valori possibili sono: - Enable - Disable - Uninstall Il valore predefinito è Enable. L'elemento State è disponibile solo con la versione 2014-06-01 o successiva.

NamedRoles

Specifica un elenco di estensioni applicate a ruoli specifici in una distribuzione.

Nome dell'elemento	Descrizione
Ruolo	Obbligatorio. Specifica un determinato ruolo a cui viene aggiunta l'estensione.
RoleName	Obbligatorio. Specifica il nome del ruolo.
Estensione	Obbligatorio. Specifica un'estensione che deve essere distribuita in un ruolo in un servizio cloud.

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 Get Operation Status 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

Per eseguire un aggiornamento automatico di una distribuzione, chiamare Upgrade Deployment o Change Deployment Configuration con l'elemento Mode impostato su automatic. L'aggiornamento continua da tale punto senza necessità di ulteriore input. È possibile chiamare Get Operation Status per determinare al termine dell'aggiornamento.

Per eseguire un aggiornamento manuale, chiamare prima Distribuzione aggiornamenti con l'elemento Mode impostato su manual. Chiamare quindi WalkUpgradeDomain per aggiornare ogni dominio all'interno della distribuzione. Assicurarsi che l'operazione sia completata chiamando Get Operation Status prima di aggiornare il dominio successivo.

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.

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

Per determinare il dominio di aggiornamento in cui è in esecuzione un'istanza specifica, usare la proprietà UpdateDomain della classe RoleInstance.